/ Mac Power 1997 January / macpower199701.bin / AMUG / Programming_10 / ICPAppSource+ICprogKit / ICProgKit 1.3.sit / ICProgKit1.3 / APIs / ICCAPI.h

< prev

next >

MacOS 8.1

Win98

DOS

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 08 49 43 43 41 50 49 | 2e 68 00 00 00 00 00 00 |..ICCAPI|.h......|
|00000010| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 54 45 58 54 43 57 49 | 45 01 00 00 00 00 00 00 |.TEXTCWI|E.......|
|00000050| 00 00 00 00 00 6c 90 00 | 00 01 c8 ae 0f 3f c4 ae |.....l..|.....?..|
|00000060| 0f 3f c4 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |.?......|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 4e 54 00 00 |........|....NT..|
|00000080| 2f 2a 20 a5 a5 a5 53 74 | 61 72 74 20 48 65 61 64 |/* ...St|art Head|
|00000090| 65 72 a5 a5 a5 20 2a 2f | 0d 0d 2f 2a 20 46 69 6c |er... */|../* Fil|
|000000a0| 65 3a 20 20 20 20 20 20 | 20 20 20 49 43 43 41 50 |e:      |   ICCAP|
|000000b0| 49 2e 68 0d 20 2a 20 47 | 65 6e 65 72 61 74 65 64 |I.h. * G|enerated|
|000000c0| 20 62 79 3a 20 31 2e 30 | 64 34 0d 20 2a 20 46 6f | by: 1.0|d4. * Fo|
|000000d0| 72 3a 20 20 20 20 20 20 | 20 20 20 20 49 43 20 31 |r:      |    IC 1|
|000000e0| 2e 33 0d 20 2a 20 4f 6e | 3a 20 20 20 20 20 20 20 |.3. * On|:       |
|000000f0| 20 20 20 20 53 75 6e 64 | 61 79 2c 20 31 34 20 4a |    Sund|ay, 14 J|
|00000100| 75 6c 79 20 31 39 39 36 | 2c 20 32 30 3a 31 39 3a |uly 1996|, 20:19:|
|00000110| 35 35 0d 20 2a 20 0d 20 | 2a 20 54 68 69 73 20 66 |55. * . |* This f|
|00000120| 69 6c 65 20 69 73 20 70 | 61 72 74 20 6f 66 20 74 |ile is p|art of t|
|00000130| 68 65 20 49 6e 74 65 72 | 6e 65 74 20 43 6f 6e 66 |he Inter|net Conf|
|00000140| 69 67 75 72 61 74 69 6f | 6e 20 73 79 73 74 65 6d |iguratio|n system|
|00000150| 20 61 6e 64 0d 20 2a 20 | 69 73 20 70 6c 61 63 65 | and. * |is place|
|00000160| 64 20 69 6e 20 74 68 65 | 20 70 75 62 6c 69 63 20 |d in the| public |
|00000170| 64 6f 6d 61 69 6e 20 66 | 6f 72 20 74 68 65 20 62 |domain f|or the b|
|00000180| 65 6e 65 66 69 74 20 6f | 66 20 61 6c 6c 2e 0d 20 |enefit o|f all.. |
|00000190| 2a 2f 0d 0d 2f 2a 20 a5 | a5 a5 45 6e 64 20 48 65 |*/../* .|..End He|
|000001a0| 61 64 65 72 a5 a5 a5 20 | 2a 2f 0d 0d 2f 2a 0d 09 |ader... |*/../*..|
|000001b0| 49 4d 50 4f 52 54 41 4e | 54 20 4e 4f 54 45 53 20 |IMPORTAN|T NOTES |
|000001c0| 41 42 4f 55 54 20 54 48 | 45 20 43 20 43 4f 4e 56 |ABOUT TH|E C CONV|
|000001d0| 45 52 53 49 4f 4e 0d 09 | 2d 2d 2d 2d 2d 2d 2d 2d |ERSION..|--------|
|000001e0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000001f0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 0d 09 |--------|------..|
|00000200| 0d 09 6f 20 50 61 73 63 | 61 6c 20 22 76 61 72 22 |..o Pasc|al "var"|
|00000210| 20 70 61 72 61 6d 65 74 | 65 72 73 20 61 72 65 20 | paramet|ers are |
|00000220| 63 6f 6e 76 65 72 74 65 | 64 20 66 72 6f 6d 20 22 |converte|d from "|
|00000230| 76 61 72 20 78 20 3a 20 | 79 22 20 74 6f 20 22 79 |var x : |y" to "y|
|00000240| 20 2a 78 22 2e 20 20 54 | 68 69 73 0d 09 20 20 6d | *x".  T|his..  m|
|00000250| 65 61 6e 73 20 74 68 61 | 74 20 77 68 65 6e 20 79 |eans tha|t when y|
|00000260| 6f 75 20 73 65 65 20 74 | 68 65 20 70 61 72 61 6d |ou see t|he param|
|00000270| 65 74 65 72 20 22 79 20 | 2a 78 22 20 79 6f 75 20 |eter "y |*x" you |
|00000280| 73 68 6f 75 6c 64 20 62 | 65 20 61 77 61 72 65 20 |should b|e aware |
|00000290| 74 68 61 74 0d 09 09 79 | 6f 75 20 2a 63 61 6e 6e |that...y|ou *cann|
|000002a0| 6f 74 20 70 61 73 73 20 | 69 6e 20 6e 69 6c 2a 2e |ot pass |in nil*.|
|000002b0| 20 20 49 6e 20 66 75 74 | 75 72 65 20 74 68 69 73 |  In fut|ure this|
|000002c0| 20 72 65 73 74 72 69 63 | 74 69 6f 6e 20 6d 61 79 | restric|tion may|
|000002d0| 20 62 65 20 65 61 73 65 | 64 2c 0d 09 09 65 73 70 | be ease|d,...esp|
|000002e0| 65 63 69 61 6c 6c 79 20 | 66 6f 72 20 74 68 65 20 |ecially |for the |
|000002f0| 61 74 74 72 20 70 61 72 | 61 6d 65 74 65 72 20 74 |attr par|ameter t|
|00000300| 6f 20 49 43 47 65 74 50 | 72 65 66 2e 20 20 50 61 |o ICGetP|ref.  Pa|
|00000310| 72 61 6d 65 74 65 72 73 | 20 77 68 65 72 65 20 6e |rameters| where n|
|00000320| 69 6c 0d 09 09 69 73 20 | 6c 65 67 61 6c 20 61 72 |il...is |legal ar|
|00000330| 65 20 64 65 63 6c 61 72 | 65 64 20 75 73 69 6e 67 |e declar|ed using|
|00000340| 20 74 68 65 20 65 78 70 | 6c 69 63 69 74 20 70 6f | the exp|licit po|
|00000350| 69 6e 74 65 72 20 74 79 | 70 65 2c 20 69 65 20 22 |inter ty|pe, ie "|
|00000360| 79 50 74 72 20 78 22 2e | 0d 0d 09 6f 20 53 74 72 |yPtr x".|...o Str|
|00000370| 69 6e 67 73 20 61 72 65 | 20 2a 50 61 73 63 61 6c |ings are| *Pascal|
|00000380| 2a 20 73 74 72 69 6e 67 | 73 2e 20 20 54 68 69 73 |* string|s.  This|
|00000390| 20 6d 65 61 6e 73 20 74 | 68 61 74 20 74 68 65 79 | means t|hat they|
|000003a0| 20 6d 75 73 74 20 62 65 | 20 77 6f 72 64 20 61 6c | must be| word al|
|000003b0| 69 67 6e 65 64 2e 0d 09 | 09 4d 50 57 20 61 6e 64 |igned...|.MPW and|
|000003c0| 20 54 68 69 6e 6b 20 43 | 20 64 6f 20 74 68 69 73 | Think C| do this|
|000003d0| 20 61 75 74 6f 6d 61 74 | 69 63 61 6c 6c 79 2e 20 | automat|ically. |
|000003e0| 20 54 68 65 20 6c 61 73 | 74 20 74 69 6d 65 20 49 | The las|t time I|
|000003f0| 20 63 68 65 63 6b 2c 20 | 4d 65 74 72 6f 77 65 72 | check, |Metrower|
|00000400| 6b 73 0d 09 09 43 20 64 | 6f 65 73 20 6e 6f 74 2e |ks...C d|oes not.|
|00000410| 20 20 49 66 20 69 74 20 | 73 74 69 6c 6c 20 64 6f |  If it |still do|
|00000420| 65 73 6e 27 74 2c 20 74 | 68 65 6e 20 49 4d 48 4f |esn't, t|hen IMHO|
|00000430| 20 69 74 27 73 20 61 20 | 62 75 67 20 69 6e 20 74 | it's a |bug in t|
|00000440| 68 65 69 72 20 63 6f 6d | 70 69 6c 65 72 0d 09 09 |heir com|piler...|
|00000450| 61 6e 64 20 79 6f 75 20 | 73 68 6f 75 6c 64 20 72 |and you |should r|
|00000460| 65 70 6f 72 74 20 69 74 | 20 74 6f 20 74 68 65 6d |eport it| to them|
|00000470| 2e 0d 0d 09 6f 20 54 68 | 65 20 63 61 6e 6f 6e 69 |....o Th|e canoni|
|00000480| 63 61 6c 20 49 6e 74 65 | 72 6e 65 74 20 43 6f 6e |cal Inte|rnet Con|
|00000490| 66 69 67 20 69 6e 74 65 | 72 66 61 63 65 20 69 73 |fig inte|rface is|
|000004a0| 20 64 65 66 69 6e 65 64 | 20 69 6e 20 50 61 73 63 | defined| in Pasc|
|000004b0| 61 6c 2e 20 20 54 68 65 | 73 65 0d 09 09 68 65 61 |al.  The|se...hea|
|000004c0| 64 65 72 73 20 68 61 76 | 65 20 6e 6f 74 20 62 65 |ders hav|e not be|
|000004d0| 65 6e 20 74 68 6f 72 6f | 75 67 68 6c 79 20 74 65 |en thoro|ughly te|
|000004e0| 73 74 65 64 2e 20 20 49 | 66 20 74 68 65 72 65 20 |sted.  I|f there |
|000004f0| 69 73 20 61 20 63 6f 6e | 66 6c 69 63 74 20 62 65 |is a con|flict be|
|00000500| 74 77 65 65 6e 0d 09 09 | 74 68 65 73 65 20 68 65 |tween...|these he|
|00000510| 61 64 65 72 73 20 61 6e | 64 20 74 68 65 20 50 61 |aders an|d the Pa|
|00000520| 73 63 61 6c 20 69 6e 74 | 65 72 66 61 63 65 73 2c |scal int|erfaces,|
|00000530| 20 74 68 65 20 50 61 73 | 63 61 6c 20 73 68 6f 75 | the Pas|cal shou|
|00000540| 6c 64 20 74 61 6b 65 20 | 70 72 65 63 65 64 65 6e |ld take |preceden|
|00000550| 63 65 2e 0d 2a 2f 0d 0d | 2f 2a 20 2f 2f 2f 2f 2f |ce..*/..|/* /////|
|00000560| 2f 2f 2f 2f 2f 2f 2f 2f | 2f 2f 2f 2f 2f 2f 2f 2f |////////|////////|
|00000570| 2f 2f 2f 2f 2f 2f 2f 2f | 2f 2f 2f 2f 2f 2f 2f 2f |////////|////////|
|00000580| 2f 2f 2f 2f 2f 2f 2f 2f | 2f 2f 2f 2f 2f 2f 2f 2f |////////|////////|
|00000590| 2f 2f 2f 2f 2f 2f 2f 2f | 2f 2f 2f 2f 2f 2f 2f 2f |////////|////////|
|000005a0| 2f 2f 2f 2f 2f 2f 2f 2f | 2f 2f 2f 2f 20 2a 2f 0d |////////|//// */.|
|000005b0| 0d 23 69 66 6e 64 65 66 | 20 5f 5f 49 43 43 41 50 |.#ifndef| __ICCAP|
|000005c0| 49 5f 5f 0d 23 64 65 66 | 69 6e 65 20 5f 5f 49 43 |I__.#def|ine __IC|
|000005d0| 43 41 50 49 5f 5f 0d 0d | 23 69 66 6e 64 65 66 20 |CAPI__..|#ifndef |
|000005e0| 5f 5f 54 59 50 45 53 5f | 5f 0d 23 69 6e 63 6c 75 |__TYPES_|_.#inclu|
|000005f0| 64 65 20 3c 54 79 70 65 | 73 2e 68 3e 0d 23 65 6e |de <Type|s.h>.#en|
|00000600| 64 69 66 0d 0d 23 69 66 | 6e 64 65 66 20 5f 5f 46 |dif..#if|ndef __F|
|00000610| 49 4c 45 53 5f 5f 0d 23 | 69 6e 63 6c 75 64 65 20 |ILES__.#|include |
|00000620| 3c 46 69 6c 65 73 2e 68 | 3e 0d 23 65 6e 64 69 66 |<Files.h|>.#endif|
|00000630| 0d 0d 23 69 66 6e 64 65 | 66 20 5f 5f 43 4f 4d 50 |..#ifnde|f __COMP|
|00000640| 4f 4e 45 4e 54 53 5f 5f | 0d 23 69 6e 63 6c 75 64 |ONENTS__|.#includ|
|00000650| 65 20 3c 43 6f 6d 70 6f | 6e 65 6e 74 73 2e 68 3e |e <Compo|nents.h>|
|00000660| 0d 23 65 6e 64 69 66 0d | 0d 23 69 66 6e 64 65 66 |.#endif.|.#ifndef|
|00000670| 20 5f 5f 49 43 54 59 50 | 45 53 5f 5f 0d 23 69 6e | __ICTYP|ES__.#in|
|00000680| 63 6c 75 64 65 20 22 49 | 43 54 79 70 65 73 2e 68 |clude "I|CTypes.h|
|00000690| 22 0d 23 65 6e 64 69 66 | 0d 0d 23 69 66 6e 64 65 |".#endif|..#ifnde|
|000006a0| 66 20 5f 5f 49 43 4b 45 | 59 53 5f 5f 0d 23 69 6e |f __ICKE|YS__.#in|
|000006b0| 63 6c 75 64 65 20 22 49 | 43 4b 65 79 73 2e 68 22 |clude "I|CKeys.h"|
|000006c0| 0d 23 65 6e 64 69 66 0d | 0d 2f 2a 20 2f 2f 2f 2f |.#endif.|./* ////|
|000006d0| 2f 2f 2f 2f 2f 2f 2f 2f | 2f 2f 2f 2f 2f 2f 2f 2f |////////|////////|
|000006e0| 2f 2f 2f 2f 2f 2f 2f 2f | 2f 2f 2f 2f 2f 2f 2f 2f |////////|////////|
|000006f0| 2f 2f 2f 2f 2f 2f 2f 2f | 2f 2f 2f 2f 2f 2f 2f 2f |////////|////////|
|00000700| 2f 2f 2f 2f 2f 2f 2f 2f | 2f 2f 2f 2f 2f 2f 2f 2f |////////|////////|
|00000710| 2f 2f 2f 2f 2f 2f 2f 2f | 2f 2f 2f 2f 20 2a 2f 0d |////////|//// */.|
|00000720| 0d 65 6e 75 6d 20 7b 0d | 09 69 6e 74 65 72 6e 65 |.enum {.|.interne|
|00000730| 74 43 6f 6e 66 69 67 75 | 72 61 74 69 6f 6e 43 6f |tConfigu|rationCo|
|00000740| 6d 70 6f 6e 65 6e 74 54 | 79 70 65 20 3d 20 27 50 |mponentT|ype = 'P|
|00000750| 52 45 46 27 2c 09 09 09 | 09 09 09 09 2f 2a 20 74 |REF',...|..../* t|
|00000760| 68 65 20 63 6f 6d 70 6f | 6e 65 6e 74 20 74 79 70 |he compo|nent typ|
|00000770| 65 20 2a 2f 0d 09 69 6e | 74 65 72 6e 65 74 43 6f |e */..in|ternetCo|
|00000780| 6e 66 69 67 75 72 61 74 | 69 6f 6e 43 6f 6d 70 6f |nfigurat|ionCompo|
|00000790| 6e 65 6e 74 53 75 62 54 | 79 70 65 20 3d 20 27 49 |nentSubT|ype = 'I|
|000007a0| 43 41 70 27 2c 09 09 09 | 09 09 20 20 2f 2a 20 74 |CAp',...|..  /* t|
|000007b0| 68 65 20 63 6f 6d 70 6f | 6e 65 6e 74 20 73 75 62 |he compo|nent sub|
|000007c0| 74 79 70 65 20 2a 2f 0d | 09 69 6e 74 65 72 6e 65 |type */.|.interne|
|000007d0| 74 43 6f 6e 66 69 67 75 | 72 61 74 69 6f 6e 43 6f |tConfigu|rationCo|
|000007e0| 6d 70 6f 6e 65 6e 74 49 | 6e 74 65 72 66 61 63 65 |mponentI|nterface|
|000007f0| 56 65 72 73 69 6f 6e 30 | 20 3d 20 30 78 30 30 30 |Version0| = 0x000|
|00000800| 30 30 30 30 30 4c 2c 0d | 09 69 6e 74 65 72 6e 65 |00000L,.|.interne|
|00000810| 74 43 6f 6e 66 69 67 75 | 72 61 74 69 6f 6e 43 6f |tConfigu|rationCo|
|00000820| 6d 70 6f 6e 65 6e 74 49 | 6e 74 65 72 66 61 63 65 |mponentI|nterface|
|00000830| 56 65 72 73 69 6f 6e 31 | 20 3d 20 30 78 30 30 30 |Version1| = 0x000|
|00000840| 31 30 30 30 30 4c 2c 0d | 09 69 6e 74 65 72 6e 65 |10000L,.|.interne|
|00000850| 74 43 6f 6e 66 69 67 75 | 72 61 74 69 6f 6e 43 6f |tConfigu|rationCo|
|00000860| 6d 70 6f 6e 65 6e 74 49 | 6e 74 65 72 66 61 63 65 |mponentI|nterface|
|00000870| 56 65 72 73 69 6f 6e 32 | 20 3d 20 30 78 30 30 30 |Version2| = 0x000|
|00000880| 32 30 30 30 30 4c 2c 0d | 09 2f 2a 20 63 75 72 72 |20000L,.|./* curr|
|00000890| 65 6e 74 20 76 65 72 73 | 69 6f 6e 20 6e 75 6d 62 |ent vers|ion numb|
|000008a0| 65 72 20 69 73 20 76 65 | 72 73 69 6f 6e 20 32 20 |er is ve|rsion 2 |
|000008b0| 2a 2f 0d 09 69 6e 74 65 | 72 6e 65 74 43 6f 6e 66 |*/..inte|rnetConf|
|000008c0| 69 67 75 72 61 74 69 6f | 6e 43 6f 6d 70 6f 6e 65 |iguratio|nCompone|
|000008d0| 6e 74 49 6e 74 65 72 66 | 61 63 65 56 65 72 73 69 |ntInterf|aceVersi|
|000008e0| 6f 6e 20 3d 20 69 6e 74 | 65 72 6e 65 74 43 6f 6e |on = int|ernetCon|
|000008f0| 66 69 67 75 72 61 74 69 | 6f 6e 43 6f 6d 70 6f 6e |figurati|onCompon|
|00000900| 65 6e 74 49 6e 74 65 72 | 66 61 63 65 56 65 72 73 |entInter|faceVers|
|00000910| 69 6f 6e 32 0d 7d 3b 0d | 0d 74 79 70 65 64 65 66 |ion2.};.|.typedef|
|00000920| 20 43 6f 6d 70 6f 6e 65 | 6e 74 49 6e 73 74 61 6e | Compone|ntInstan|
|00000930| 63 65 20 69 6e 74 65 72 | 6e 65 74 43 6f 6e 66 69 |ce inter|netConfi|
|00000940| 67 75 72 61 74 69 6f 6e | 43 6f 6d 70 6f 6e 65 6e |guration|Componen|
|00000950| 74 3b 0d 0d 23 69 66 64 | 65 66 20 5f 5f 63 70 6c |t;..#ifd|ef __cpl|
|00000960| 75 73 70 6c 75 73 0d 65 | 78 74 65 72 6e 20 22 43 |usplus.e|xtern "C|
|00000970| 22 20 7b 0d 23 65 6e 64 | 69 66 20 5f 5f 63 70 6c |" {.#end|if __cpl|
|00000980| 75 73 70 6c 75 73 0d 0d | 2f 2a 20 a5 a5 a5 53 74 |usplus..|/* ...St|
|00000990| 61 72 74 20 49 43 43 41 | 50 49 2e 68 a5 a5 a5 20 |art ICCA|PI.h... |
|000009a0| 2a 2f 0d 0d 2f 2a 20 2a | 2a 2a 2a 2a 20 53 74 61 |*/../* *|**** Sta|
|000009b0| 72 74 69 6e 67 20 55 70 | 20 61 6e 64 20 53 68 75 |rting Up| and Shu|
|000009c0| 74 74 69 6e 67 20 44 6f | 77 6e 20 2a 2a 2a 2a 2a |tting Do|wn *****|
|000009d0| 20 2a 2f 0d 0d 70 61 73 | 63 61 6c 20 49 43 45 72 | */..pas|cal ICEr|
|000009e0| 72 6f 72 20 49 43 43 53 | 74 61 72 74 28 69 6e 74 |ror ICCS|tart(int|
|000009f0| 65 72 6e 65 74 43 6f 6e | 66 69 67 75 72 61 74 69 |ernetCon|figurati|
|00000a00| 6f 6e 43 6f 6d 70 6f 6e | 65 6e 74 20 2a 69 6e 73 |onCompon|ent *ins|
|00000a10| 74 2c 20 4f 53 54 79 70 | 65 20 63 72 65 61 74 6f |t, OSTyp|e creato|
|00000a20| 72 29 3b 0d 20 20 2f 2a | 20 43 61 6c 6c 20 74 68 |r);.  /*| Call th|
|00000a30| 69 73 20 61 74 20 61 70 | 70 6c 69 63 61 74 69 6f |is at ap|plicatio|
|00000a40| 6e 20 69 6e 69 74 69 61 | 6c 69 73 61 74 69 6f 6e |n initia|lisation|
|00000a50| 2e 20 53 65 74 20 63 72 | 65 61 74 6f 72 20 74 6f |. Set cr|eator to|
|00000a60| 20 79 6f 75 72 20 61 70 | 70 6c 69 63 61 74 69 6f | your ap|plicatio|
|00000a70| 6e 0d 20 20 20 2a 20 63 | 72 65 61 74 6f 72 20 74 |n.   * c|reator t|
|00000a80| 6f 20 61 6c 6c 6f 77 20 | 66 6f 72 20 66 75 74 75 |o allow |for futu|
|00000a90| 72 65 20 65 78 70 61 6e | 73 69 6f 6e 20 6f 66 20 |re expan|sion of |
|00000aa0| 74 68 65 20 49 43 20 73 | 79 73 74 65 6d 2e 20 52 |the IC s|ystem. R|
|00000ab0| 65 74 75 72 6e 73 0d 20 | 20 20 2a 20 69 6e 73 74 |eturns. |  * inst|
|00000ac0| 20 61 73 20 61 20 63 6f | 6e 6e 65 63 74 69 6f 6e | as a co|nnection|
|00000ad0| 20 74 6f 20 74 68 65 20 | 49 43 20 73 79 73 74 65 | to the |IC syste|
|00000ae0| 6d 2e 0d 20 20 20 2a 2f | 0d 0d 70 61 73 63 61 6c |m..   */|..pascal|
|00000af0| 20 49 43 45 72 72 6f 72 | 20 49 43 43 53 74 6f 70 | ICError| ICCStop|
|00000b00| 28 69 6e 74 65 72 6e 65 | 74 43 6f 6e 66 69 67 75 |(interne|tConfigu|
|00000b10| 72 61 74 69 6f 6e 43 6f | 6d 70 6f 6e 65 6e 74 20 |rationCo|mponent |
|00000b20| 69 6e 73 74 29 3b 0d 20 | 20 2f 2a 20 49 74 20 69 |inst);. | /* It i|
|00000b30| 73 20 69 6c 6c 65 67 61 | 6c 20 74 6f 20 63 61 6c |s illega|l to cal|
|00000b40| 6c 20 74 68 69 73 20 72 | 6f 75 74 69 6e 65 20 69 |l this r|outine i|
|00000b50| 6e 73 69 64 65 20 61 20 | 49 43 42 65 67 69 6e 2f |nside a |ICBegin/|
|00000b60| 45 6e 64 20 70 61 69 72 | 2e 0d 20 20 20 2a 20 43 |End pair|..   * C|
|00000b70| 61 6c 6c 20 74 68 69 73 | 20 61 74 20 61 70 70 6c |all this| at appl|
|00000b80| 69 63 61 74 69 6f 6e 20 | 69 6e 69 74 69 61 6c 69 |ication |initiali|
|00000b90| 73 61 74 69 6f 6e 2c 20 | 61 66 74 65 72 20 77 68 |sation, |after wh|
|00000ba0| 69 63 68 20 69 6e 73 74 | 0d 20 20 20 2a 20 69 73 |ich inst|.   * is|
|00000bb0| 20 6e 6f 20 6c 6f 6e 67 | 65 72 20 76 61 6c 69 64 | no long|er valid|
|00000bc0| 20 63 6f 6e 6e 65 63 74 | 69 6f 6e 20 74 6f 20 49 | connect|ion to I|
|00000bd0| 43 2e 0d 20 20 20 2a 2f | 0d 0d 2f 2a 20 2a 2a 2a |C..   */|../* ***|
|00000be0| 2a 2a 20 53 70 65 63 69 | 66 79 69 6e 67 20 61 20 |** Speci|fying a |
|00000bf0| 43 6f 6e 66 69 67 75 72 | 61 74 69 6f 6e 20 2a 2a |Configur|ation **|
|00000c00| 2a 2a 2a 20 2a 2f 0d 0d | 70 61 73 63 61 6c 20 49 |*** */..|pascal I|
|00000c10| 43 45 72 72 6f 72 20 49 | 43 43 46 69 6e 64 43 6f |CError I|CCFindCo|
|00000c20| 6e 66 69 67 46 69 6c 65 | 28 69 6e 74 65 72 6e 65 |nfigFile|(interne|
|00000c30| 74 43 6f 6e 66 69 67 75 | 72 61 74 69 6f 6e 43 6f |tConfigu|rationCo|
|00000c40| 6d 70 6f 6e 65 6e 74 20 | 69 6e 73 74 2c 20 73 68 |mponent |inst, sh|
|00000c50| 6f 72 74 20 63 6f 75 6e | 74 2c 20 49 43 44 69 72 |ort coun|t, ICDir|
|00000c60| 53 70 65 63 41 72 72 61 | 79 50 74 72 20 66 6f 6c |SpecArra|yPtr fol|
|00000c70| 64 65 72 73 29 0d 46 49 | 56 45 57 4f 52 44 49 4e |ders).FI|VEWORDIN|
|00000c80| 4c 49 4e 45 28 30 78 32 | 46 33 43 2c 20 36 2c 20 |LINE(0x2|F3C, 6, |
|00000c90| 32 2c 20 30 78 37 30 30 | 30 2c 20 30 78 41 38 32 |2, 0x700|0, 0xA82|
|00000ca0| 41 29 3b 0d 20 20 2f 2a | 20 49 74 20 69 73 20 69 |A);.  /*| It is i|
|00000cb0| 6c 6c 65 67 61 6c 20 74 | 6f 20 63 61 6c 6c 20 74 |llegal t|o call t|
|00000cc0| 68 69 73 20 72 6f 75 74 | 69 6e 65 20 69 6e 73 69 |his rout|ine insi|
|00000cd0| 64 65 20 61 20 49 43 42 | 65 67 69 6e 2f 45 6e 64 |de a ICB|egin/End|
|00000ce0| 20 70 61 69 72 2e 0d 20 | 20 20 2a 20 43 61 6c 6c | pair.. |  * Call|
|00000cf0| 20 74 6f 20 63 6f 6e 66 | 69 67 75 72 65 20 74 68 | to conf|igure th|
|00000d00| 69 73 20 63 6f 6e 6e 65 | 63 74 69 6f 6e 20 74 6f |is conne|ction to|
|00000d10| 20 49 43 2e 0d 20 20 20 | 2a 20 53 65 74 20 63 6f | IC..   |* Set co|
|00000d20| 75 6e 74 20 61 73 20 74 | 68 65 20 6e 75 6d 62 65 |unt as t|he numbe|
|00000d30| 72 20 6f 66 20 76 61 6c | 69 64 20 65 6c 65 6d 65 |r of val|id eleme|
|00000d40| 6e 74 73 20 69 6e 20 66 | 6f 6c 64 65 72 73 2e 0d |nts in f|olders..|
|00000d50| 20 20 20 2a 20 53 65 74 | 20 66 6f 6c 64 65 72 73 |   * Set| folders|
|00000d60| 20 74 6f 20 61 20 70 6f | 69 6e 74 65 72 20 74 6f | to a po|inter to|
|00000d70| 20 74 68 65 20 66 6f 6c | 64 65 72 73 20 74 6f 20 | the fol|ders to |
|00000d80| 73 65 61 72 63 68 2e 0d | 20 20 20 2a 20 53 65 74 |search..|   * Set|
|00000d90| 74 69 6e 67 20 63 6f 75 | 6e 74 20 74 6f 20 30 20 |ting cou|nt to 0 |
|00000da0| 61 6e 64 20 66 6f 6c 64 | 65 72 73 20 74 6f 20 6e |and fold|ers to n|
|00000db0| 69 6c 20 69 73 20 4f 4b | 2e 0d 20 20 20 2a 20 53 |il is OK|..   * S|
|00000dc0| 65 61 72 63 68 65 73 20 | 74 68 65 20 73 70 65 63 |earches |the spec|
|00000dd0| 69 66 69 65 64 20 66 6f | 6c 64 65 72 73 20 61 6e |ified fo|lders an|
|00000de0| 64 20 74 68 65 6e 20 74 | 68 65 20 50 72 65 66 65 |d then t|he Prefe|
|00000df0| 72 65 6e 63 65 73 20 66 | 6f 6c 64 65 72 0d 20 20 |rences f|older.  |
|00000e00| 20 2a 20 69 6e 20 61 20 | 75 6e 73 70 65 63 69 66 | * in a |unspecif|
|00000e10| 69 65 64 20 6d 61 6e 6e | 65 72 2e 0d 20 20 20 2a |ied mann|er..   *|
|00000e20| 2f 0d 0d 70 61 73 63 61 | 6c 20 49 43 45 72 72 6f |/..pasca|l ICErro|
|00000e30| 72 20 49 43 43 46 69 6e | 64 55 73 65 72 43 6f 6e |r ICCFin|dUserCon|
|00000e40| 66 69 67 46 69 6c 65 28 | 69 6e 74 65 72 6e 65 74 |figFile(|internet|
|00000e50| 43 6f 6e 66 69 67 75 72 | 61 74 69 6f 6e 43 6f 6d |Configur|ationCom|
|00000e60| 70 6f 6e 65 6e 74 20 69 | 6e 73 74 2c 20 49 43 44 |ponent i|nst, ICD|
|00000e70| 69 72 53 70 65 63 20 2a | 77 68 65 72 65 29 0d 46 |irSpec *|where).F|
|00000e80| 49 56 45 57 4f 52 44 49 | 4e 4c 49 4e 45 28 30 78 |IVEWORDI|NLINE(0x|
|00000e90| 32 46 33 43 2c 20 34 2c | 20 31 34 2c 20 30 78 37 |2F3C, 4,| 14, 0x7|
|00000ea0| 30 30 30 2c 20 30 78 41 | 38 32 41 29 3b 0d 20 20 |000, 0xA|82A);.  |
|00000eb0| 2f 2a 20 52 65 71 75 69 | 72 65 73 20 49 43 20 31 |/* Requi|res IC 1|
|00000ec0| 2e 31 2e 0d 20 20 20 2a | 20 49 74 20 69 73 20 69 |.1..   *| It is i|
|00000ed0| 6c 6c 65 67 61 6c 20 74 | 6f 20 63 61 6c 6c 20 74 |llegal t|o call t|
|00000ee0| 68 69 73 20 72 6f 75 74 | 69 6e 65 20 69 6e 73 69 |his rout|ine insi|
|00000ef0| 64 65 20 61 20 49 43 42 | 65 67 69 6e 2f 45 6e 64 |de a ICB|egin/End|
|00000f00| 20 70 61 69 72 2e 0d 20 | 20 20 2a 20 53 69 6d 69 | pair.. |  * Simi|
|00000f10| 6c 61 72 20 74 6f 20 49 | 43 46 69 6e 64 43 6f 6e |lar to I|CFindCon|
|00000f20| 66 69 67 46 69 6c 65 20 | 65 78 63 65 70 74 20 74 |figFile |except t|
|00000f30| 68 61 74 20 69 74 20 6f | 6e 6c 79 20 73 65 61 72 |hat it o|nly sear|
|00000f40| 63 68 65 73 20 74 68 65 | 20 66 6f 6c 64 65 72 0d |ches the| folder.|
|00000f50| 20 20 20 2a 20 73 70 65 | 63 69 66 69 65 64 20 69 |   * spe|cified i|
|00000f60| 6e 20 77 68 65 72 65 2e | 20 20 49 66 20 74 68 65 |n where.|  If the|
|00000f70| 20 69 6e 70 75 74 20 70 | 61 72 61 6d 65 74 65 72 | input p|arameter|
|00000f80| 73 20 61 72 65 20 76 61 | 6c 69 64 20 74 68 65 20 |s are va|lid the |
|00000f90| 72 6f 75 74 69 6e 65 0d | 20 20 20 2a 20 77 69 6c |routine.|   * wil|
|00000fa0| 6c 20 61 6c 77 61 79 73 | 20 73 75 63 63 65 73 73 |l always| success|
|00000fb0| 66 75 6c 20 63 6f 6e 66 | 69 67 75 72 65 20 74 68 |ful conf|igure th|
|00000fc0| 65 20 69 6e 73 74 61 6e | 63 65 2c 20 63 72 65 61 |e instan|ce, crea|
|00000fd0| 74 69 6e 67 20 61 6e 0d | 20 20 20 2a 20 65 6d 70 |ting an.|   * emp|
|00000fe0| 74 79 20 63 6f 6e 66 69 | 67 75 72 61 74 69 6f 6e |ty confi|guration|
|00000ff0| 20 69 66 20 6e 65 63 65 | 73 73 61 72 79 0d 20 20 | if nece|ssary.  |
|00001000| 20 2a 20 46 6f 72 20 75 | 73 65 20 77 69 74 68 20 | * For u|se with |
|00001010| 64 6f 75 62 6c 65 2d 63 | 6c 69 63 6b 61 62 6c 65 |double-c|lickable|
|00001020| 20 70 72 65 66 65 72 65 | 6e 63 65 20 66 69 6c 65 | prefere|nce file|
|00001030| 73 2e 0d 20 20 20 2a 2f | 0d 0d 70 61 73 63 61 6c |s..   */|..pascal|
|00001040| 20 49 43 45 72 72 6f 72 | 20 49 43 43 47 65 6e 65 | ICError| ICCGene|
|00001050| 72 61 6c 46 69 6e 64 43 | 6f 6e 66 69 67 46 69 6c |ralFindC|onfigFil|
|00001060| 65 28 69 6e 74 65 72 6e | 65 74 43 6f 6e 66 69 67 |e(intern|etConfig|
|00001070| 75 72 61 74 69 6f 6e 43 | 6f 6d 70 6f 6e 65 6e 74 |urationC|omponent|
|00001080| 20 69 6e 73 74 2c 20 42 | 6f 6f 6c 65 61 6e 20 73 | inst, B|oolean s|
|00001090| 65 61 72 63 68 5f 70 72 | 65 66 73 2c 20 42 6f 6f |earch_pr|efs, Boo|
|000010a0| 6c 65 61 6e 20 63 61 6e | 5f 63 72 65 61 74 65 2c |lean can|_create,|
|000010b0| 20 73 68 6f 72 74 20 63 | 6f 75 6e 74 2c 20 49 43 | short c|ount, IC|
|000010c0| 44 69 72 53 70 65 63 41 | 72 72 61 79 50 74 72 20 |DirSpecA|rrayPtr |
|000010d0| 66 6f 6c 64 65 72 73 29 | 0d 46 49 56 45 57 4f 52 |folders)|.FIVEWOR|
|000010e0| 44 49 4e 4c 49 4e 45 28 | 30 78 32 46 33 43 2c 20 |DINLINE(|0x2F3C, |
|000010f0| 31 30 2c 20 33 30 2c 20 | 30 78 37 30 30 30 2c 20 |10, 30, |0x7000, |
|00001100| 30 78 41 38 32 41 29 3b | 0d 20 20 2f 2a 20 52 65 |0xA82A);|.  /* Re|
|00001110| 71 75 69 72 65 73 20 49 | 43 20 31 2e 32 2e 0d 20 |quires I|C 1.2.. |
|00001120| 20 20 2a 20 49 74 20 69 | 73 20 69 6c 6c 65 67 61 |  * It i|s illega|
|00001130| 6c 20 74 6f 20 63 61 6c | 6c 20 74 68 69 73 20 72 |l to cal|l this r|
|00001140| 6f 75 74 69 6e 65 20 69 | 6e 73 69 64 65 20 61 20 |outine i|nside a |
|00001150| 49 43 42 65 67 69 6e 2f | 45 6e 64 20 70 61 69 72 |ICBegin/|End pair|
|00001160| 2e 0d 20 20 20 2a 20 43 | 61 6c 6c 20 74 6f 20 63 |..   * C|all to c|
|00001170| 6f 6e 66 69 67 75 72 65 | 20 74 68 69 73 20 63 6f |onfigure| this co|
|00001180| 6e 6e 65 63 74 69 6f 6e | 20 74 6f 20 49 43 2e 0d |nnection| to IC..|
|00001190| 20 20 20 2a 20 54 68 69 | 73 20 72 6f 75 74 69 6e |   * Thi|s routin|
|000011a0| 65 20 61 63 74 73 20 61 | 73 20 61 20 6d 6f 72 65 |e acts a|s a more|
|000011b0| 20 67 65 6e 65 72 61 6c | 20 72 65 70 6c 61 63 65 | general| replace|
|000011c0| 6d 65 6e 74 20 66 6f 72 | 0d 20 20 20 2a 20 49 43 |ment for|.   * IC|
|000011d0| 46 69 6e 64 43 6f 6e 66 | 69 67 46 69 6c 65 20 61 |FindConf|igFile a|
|000011e0| 6e 64 20 49 43 46 69 6e | 64 55 73 65 72 43 6f 6e |nd ICFin|dUserCon|
|000011f0| 66 69 67 46 69 6c 65 2e | 0d 20 20 20 2a 20 53 65 |figFile.|.   * Se|
|00001200| 74 20 73 65 61 72 63 68 | 5f 70 72 65 66 73 20 74 |t search|_prefs t|
|00001210| 6f 20 74 72 75 65 20 69 | 66 20 79 6f 75 20 77 61 |o true i|f you wa|
|00001220| 6e 74 20 69 74 20 74 6f | 20 73 65 61 72 63 68 20 |nt it to| search |
|00001230| 74 68 65 20 70 72 65 66 | 65 72 65 6e 63 65 73 20 |the pref|erences |
|00001240| 66 6f 6c 64 65 72 2e 0d | 20 20 20 2a 20 53 65 74 |folder..|   * Set|
|00001250| 20 63 61 6e 5f 63 72 65 | 61 74 65 20 74 6f 20 74 | can_cre|ate to t|
|00001260| 72 75 65 20 69 66 20 79 | 6f 75 20 77 61 6e 74 20 |rue if y|ou want |
|00001270| 69 74 20 74 6f 20 62 65 | 20 61 62 6c 65 20 74 6f |it to be| able to|
|00001280| 20 63 72 65 61 74 65 20 | 61 20 6e 65 77 20 63 6f | create |a new co|
|00001290| 6e 66 69 67 2e 0d 20 20 | 20 2a 20 53 65 74 20 63 |nfig..  | * Set c|
|000012a0| 6f 75 6e 74 20 61 73 20 | 74 68 65 20 6e 75 6d 62 |ount as |the numb|
|000012b0| 65 72 20 6f 66 20 76 61 | 6c 69 64 20 65 6c 65 6d |er of va|lid elem|
|000012c0| 65 6e 74 73 20 69 6e 20 | 66 6f 6c 64 65 72 73 2e |ents in |folders.|
|000012d0| 0d 20 20 20 2a 20 53 65 | 74 20 66 6f 6c 64 65 72 |.   * Se|t folder|
|000012e0| 73 20 74 6f 20 61 20 70 | 6f 69 6e 74 65 72 20 74 |s to a p|ointer t|
|000012f0| 6f 20 74 68 65 20 66 6f | 6c 64 65 72 73 20 74 6f |o the fo|lders to|
|00001300| 20 73 65 61 72 63 68 2e | 0d 20 20 20 2a 20 53 65 | search.|.   * Se|
|00001310| 74 74 69 6e 67 20 63 6f | 75 6e 74 20 74 6f 20 30 |tting co|unt to 0|
|00001320| 20 61 6e 64 20 66 6f 6c | 64 65 72 73 20 74 6f 20 | and fol|ders to |
|00001330| 6e 69 6c 20 69 73 20 4f | 4b 2e 0d 20 20 20 2a 20 |nil is O|K..   * |
|00001340| 53 65 61 72 63 68 65 73 | 20 74 68 65 20 73 70 65 |Searches| the spe|
|00001350| 63 69 66 69 65 64 20 66 | 6f 6c 64 65 72 73 20 61 |cified f|olders a|
|00001360| 6e 64 20 74 68 65 6e 20 | 6f 70 74 69 6f 6e 61 6c |nd then |optional|
|00001370| 6c 79 20 74 68 65 20 50 | 72 65 66 65 72 65 6e 63 |ly the P|referenc|
|00001380| 65 73 20 66 6f 6c 64 65 | 72 0d 20 20 20 2a 20 69 |es folde|r.   * i|
|00001390| 6e 20 61 20 75 6e 73 70 | 65 63 69 66 69 65 64 20 |n a unsp|ecified |
|000013a0| 6d 61 6e 6e 65 72 2e 0d | 20 20 20 2a 2f 0d 0d 70 |manner..|   */..p|
|000013b0| 61 73 63 61 6c 20 49 43 | 45 72 72 6f 72 20 49 43 |ascal IC|Error IC|
|000013c0| 43 43 68 6f 6f 73 65 43 | 6f 6e 66 69 67 28 69 6e |CChooseC|onfig(in|
|000013d0| 74 65 72 6e 65 74 43 6f | 6e 66 69 67 75 72 61 74 |ternetCo|nfigurat|
|000013e0| 69 6f 6e 43 6f 6d 70 6f | 6e 65 6e 74 20 69 6e 73 |ionCompo|nent ins|
|000013f0| 74 29 0d 46 49 56 45 57 | 4f 52 44 49 4e 4c 49 4e |t).FIVEW|ORDINLIN|
|00001400| 45 28 30 78 32 46 33 43 | 2c 20 30 2c 20 33 33 2c |E(0x2F3C|, 0, 33,|
|00001410| 20 30 78 37 30 30 30 2c | 20 30 78 41 38 32 41 29 | 0x7000,| 0xA82A)|
|00001420| 3b 0d 20 20 2f 2a 20 52 | 65 71 75 69 72 65 73 20 |;.  /* R|equires |
|00001430| 49 43 20 31 2e 32 2e 0d | 20 20 20 2a 20 49 74 20 |IC 1.2..|   * It |
|00001440| 69 73 20 69 6c 6c 65 67 | 61 6c 20 74 6f 20 63 61 |is illeg|al to ca|
|00001450| 6c 6c 20 74 68 69 73 20 | 72 6f 75 74 69 6e 65 20 |ll this |routine |
|00001460| 69 6e 73 69 64 65 20 61 | 20 49 43 42 65 67 69 6e |inside a| ICBegin|
|00001470| 2f 45 6e 64 20 70 61 69 | 72 2e 0d 20 20 20 2a 20 |/End pai|r..   * |
|00001480| 52 65 71 75 65 73 74 73 | 20 74 68 65 20 75 73 65 |Requests| the use|
|00001490| 72 20 74 6f 20 63 68 6f | 6f 73 65 20 61 20 63 6f |r to cho|ose a co|
|000014a0| 6e 66 69 67 75 72 61 74 | 69 6f 6e 2c 20 74 79 70 |nfigurat|ion, typ|
|000014b0| 69 63 61 6c 6c 79 20 75 | 73 69 6e 67 20 73 6f 6d |ically u|sing som|
|000014c0| 65 0d 20 20 20 2a 20 73 | 6f 72 74 20 6f 66 20 6d |e.   * s|ort of m|
|000014d0| 6f 64 61 6c 20 64 69 61 | 6c 6f 67 2e 20 49 66 20 |odal dia|log. If |
|000014e0| 74 68 65 20 75 73 65 72 | 20 63 61 6e 63 65 6c 73 |the user| cancels|
|000014f0| 20 74 68 65 20 64 69 61 | 6c 6f 67 20 74 68 65 20 | the dia|log the |
|00001500| 63 6f 6e 66 69 67 75 72 | 61 74 69 6f 6e 0d 20 20 |configur|ation.  |
|00001510| 20 2a 20 73 74 61 74 65 | 20 77 69 6c 6c 20 62 65 | * state| will be|
|00001520| 20 75 6e 61 66 66 65 63 | 74 65 64 2e 0d 20 20 20 | unaffec|ted..   |
|00001530| 2a 2f 0d 0d 70 61 73 63 | 61 6c 20 49 43 45 72 72 |*/..pasc|al ICErr|
|00001540| 6f 72 20 49 43 43 43 68 | 6f 6f 73 65 4e 65 77 43 |or ICCCh|ooseNewC|
|00001550| 6f 6e 66 69 67 28 69 6e | 74 65 72 6e 65 74 43 6f |onfig(in|ternetCo|
|00001560| 6e 66 69 67 75 72 61 74 | 69 6f 6e 43 6f 6d 70 6f |nfigurat|ionCompo|
|00001570| 6e 65 6e 74 20 69 6e 73 | 74 29 0d 46 49 56 45 57 |nent ins|t).FIVEW|
|00001580| 4f 52 44 49 4e 4c 49 4e | 45 28 30 78 32 46 33 43 |ORDINLIN|E(0x2F3C|
|00001590| 2c 20 30 2c 20 33 34 2c | 20 30 78 37 30 30 30 2c |, 0, 34,| 0x7000,|
|000015a0| 20 30 78 41 38 32 41 29 | 3b 0d 20 20 2f 2a 20 52 | 0xA82A)|;.  /* R|
|000015b0| 65 71 75 69 72 65 73 20 | 49 43 20 31 2e 32 2e 0d |equires |IC 1.2..|
|000015c0| 20 20 20 2a 20 49 74 20 | 69 73 20 69 6c 6c 65 67 |   * It |is illeg|
|000015d0| 61 6c 20 74 6f 20 63 61 | 6c 6c 20 74 68 69 73 20 |al to ca|ll this |
|000015e0| 72 6f 75 74 69 6e 65 20 | 69 6e 73 69 64 65 20 61 |routine |inside a|
|000015f0| 20 49 43 42 65 67 69 6e | 2f 45 6e 64 20 70 61 69 | ICBegin|/End pai|
|00001600| 72 2e 0d 20 20 20 2a 20 | 52 65 71 75 65 73 74 73 |r..   * |Requests|
|00001610| 20 74 68 65 20 75 73 65 | 72 20 74 6f 20 63 72 65 | the use|r to cre|
|00001620| 61 74 65 20 61 20 6e 65 | 77 20 63 6f 6e 66 69 67 |ate a ne|w config|
|00001630| 75 72 61 74 69 6f 6e 2c | 20 74 79 70 69 63 61 6c |uration,| typical|
|00001640| 6c 79 20 75 73 69 6e 67 | 20 73 6f 6d 65 0d 20 20 |ly using| some.  |
|00001650| 20 2a 20 73 6f 72 74 20 | 6f 66 20 6d 6f 64 61 6c | * sort |of modal|
|00001660| 20 64 69 61 6c 6f 67 2e | 20 49 66 20 74 68 65 20 | dialog.| If the |
|00001670| 75 73 65 72 20 63 61 6e | 63 65 6c 73 20 74 68 65 |user can|cels the|
|00001680| 20 64 69 61 6c 6f 67 20 | 74 68 65 20 63 6f 6e 66 | dialog |the conf|
|00001690| 69 67 75 72 61 74 69 6f | 6e 0d 20 20 20 2a 20 73 |iguratio|n.   * s|
|000016a0| 74 61 74 65 20 77 69 6c | 6c 20 62 65 20 75 6e 61 |tate wil|l be una|
|000016b0| 66 66 65 63 74 65 64 2e | 0d 20 20 20 2a 2f 0d 0d |ffected.|.   */..|
|000016c0| 70 61 73 63 61 6c 20 49 | 43 45 72 72 6f 72 20 49 |pascal I|CError I|
|000016d0| 43 43 47 65 74 43 6f 6e | 66 69 67 4e 61 6d 65 28 |CCGetCon|figName(|
|000016e0| 69 6e 74 65 72 6e 65 74 | 43 6f 6e 66 69 67 75 72 |internet|Configur|
|000016f0| 61 74 69 6f 6e 43 6f 6d | 70 6f 6e 65 6e 74 20 69 |ationCom|ponent i|
|00001700| 6e 73 74 2c 20 42 6f 6f | 6c 65 61 6e 20 6c 6f 6e |nst, Boo|lean lon|
|00001710| 67 6e 61 6d 65 2c 20 53 | 74 72 32 35 35 20 6e 61 |gname, S|tr255 na|
|00001720| 6d 65 29 0d 46 49 56 45 | 57 4f 52 44 49 4e 4c 49 |me).FIVE|WORDINLI|
|00001730| 4e 45 28 30 78 32 46 33 | 43 2c 20 36 2c 20 33 35 |NE(0x2F3|C, 6, 35|
|00001740| 2c 20 30 78 37 30 30 30 | 2c 20 30 78 41 38 32 41 |, 0x7000|, 0xA82A|
|00001750| 29 3b 0d 20 20 2f 2a 20 | 52 65 71 75 69 72 65 73 |);.  /* |Requires|
|00001760| 20 49 43 20 31 2e 32 2e | 0d 20 20 20 2a 20 59 6f | IC 1.2.|.   * Yo|
|00001770| 75 20 6d 75 73 74 20 73 | 70 65 63 69 66 79 20 61 |u must s|pecify a|
|00001780| 20 63 6f 6e 66 69 67 75 | 72 61 74 69 6f 6e 20 62 | configu|ration b|
|00001790| 65 66 6f 72 65 20 63 61 | 6c 6c 69 6e 67 20 74 68 |efore ca|lling th|
|000017a0| 69 73 20 72 6f 75 74 69 | 6e 65 2e 0d 20 20 20 2a |is routi|ne..   *|
|000017b0| 20 52 65 74 75 72 6e 73 | 20 61 20 73 74 72 69 6e | Returns| a strin|
|000017c0| 67 20 74 68 61 74 20 64 | 65 73 63 72 69 62 65 73 |g that d|escribes|
|000017d0| 20 74 68 65 20 63 75 72 | 72 65 6e 74 20 63 6f 6e | the cur|rent con|
|000017e0| 66 69 67 75 72 61 74 69 | 6f 6e 20 61 74 20 61 20 |figurati|on at a |
|000017f0| 75 73 65 72 0d 20 20 20 | 2a 20 6c 65 76 65 6c 2e |user.   |* level.|
|00001800| 20 53 65 74 20 6c 6f 6e | 67 6e 61 6d 65 20 74 6f | Set lon|gname to|
|00001810| 20 74 72 75 65 20 69 66 | 20 79 6f 75 20 77 61 6e | true if| you wan|
|00001820| 74 20 61 20 6c 6f 6e 67 | 20 6e 61 6d 65 2c 20 75 |t a long| name, u|
|00001830| 70 20 74 6f 20 32 35 35 | 0d 20 20 20 2a 20 63 68 |p to 255|.   * ch|
|00001840| 61 72 61 63 74 65 72 73 | 2c 20 6f 72 20 66 61 6c |aracters|, or fal|
|00001850| 73 65 20 69 66 20 79 6f | 75 20 77 61 6e 74 20 61 |se if yo|u want a|
|00001860| 20 73 68 6f 72 74 20 6e | 61 6d 65 2c 20 74 79 70 | short n|ame, typ|
|00001870| 69 63 61 6c 6c 79 20 61 | 62 6f 75 74 20 33 32 0d |ically a|bout 32.|
|00001880| 20 20 20 2a 20 63 68 61 | 72 61 63 74 65 72 73 2e |   * cha|racters.|
|00001890| 0d 20 20 20 2a 20 54 68 | 65 20 72 65 74 75 72 6e |.   * Th|e return|
|000018a0| 65 64 20 73 74 72 69 6e | 67 20 69 73 20 66 6f 72 |ed strin|g is for|
|000018b0| 20 75 73 65 72 20 64 69 | 73 70 6c 61 79 20 6f 6e | user di|splay on|
|000018c0| 6c 79 2e 20 49 66 20 79 | 6f 75 20 72 65 6c 79 20 |ly. If y|ou rely |
|000018d0| 6f 6e 20 74 68 65 0d 20 | 20 20 2a 20 65 78 61 63 |on the. |  * exac|
|000018e0| 74 20 66 6f 72 6d 61 74 | 20 6f 66 20 69 74 2c 20 |t format| of it, |
|000018f0| 79 6f 75 20 77 69 6c 6c | 20 63 6f 6e 66 6c 69 63 |you will| conflic|
|00001900| 74 20 77 69 74 68 20 61 | 6e 79 20 66 75 74 75 72 |t with a|ny futur|
|00001910| 65 20 49 43 0d 20 20 20 | 2a 20 69 6d 70 6c 65 6d |e IC.   |* implem|
|00001920| 65 6e 74 61 74 69 6f 6e | 20 74 68 61 74 20 64 6f |entation| that do|
|00001930| 65 73 6e 27 74 20 75 73 | 65 20 65 78 70 6c 69 63 |esn't us|e explic|
|00001940| 69 74 20 70 72 65 66 65 | 72 65 6e 63 65 20 66 69 |it prefe|rence fi|
|00001950| 6c 65 73 2e 0d 20 20 20 | 2a 2f 0d 0d 70 61 73 63 |les..   |*/..pasc|
|00001960| 61 6c 20 49 43 45 72 72 | 6f 72 20 49 43 43 47 65 |al ICErr|or ICCGe|
|00001970| 74 43 6f 6e 66 69 67 52 | 65 66 65 72 65 6e 63 65 |tConfigR|eference|
|00001980| 28 69 6e 74 65 72 6e 65 | 74 43 6f 6e 66 69 67 75 |(interne|tConfigu|
|00001990| 72 61 74 69 6f 6e 43 6f | 6d 70 6f 6e 65 6e 74 20 |rationCo|mponent |
|000019a0| 69 6e 73 74 2c 20 49 43 | 43 6f 6e 66 69 67 52 65 |inst, IC|ConfigRe|
|000019b0| 66 48 61 6e 64 6c 65 20 | 72 65 66 29 0d 46 49 56 |fHandle |ref).FIV|
|000019c0| 45 57 4f 52 44 49 4e 4c | 49 4e 45 28 30 78 32 46 |EWORDINL|INE(0x2F|
|000019d0| 33 43 2c 20 34 2c 20 33 | 31 2c 20 30 78 37 30 30 |3C, 4, 3|1, 0x700|
|000019e0| 30 2c 20 30 78 41 38 32 | 41 29 3b 0d 20 20 2f 2a |0, 0xA82|A);.  /*|
|000019f0| 20 52 65 71 75 69 72 65 | 73 20 49 43 20 31 2e 32 | Require|s IC 1.2|
|00001a00| 2e 0d 20 20 20 2a 20 59 | 6f 75 20 6d 75 73 74 20 |..   * Y|ou must |
|00001a10| 73 70 65 63 69 66 79 20 | 61 20 63 6f 6e 66 69 67 |specify |a config|
|00001a20| 75 72 61 74 69 6f 6e 20 | 62 65 66 6f 72 65 20 63 |uration |before c|
|00001a30| 61 6c 6c 69 6e 67 20 74 | 68 69 73 20 72 6f 75 74 |alling t|his rout|
|00001a40| 69 6e 65 2e 0d 20 20 20 | 2a 20 52 65 74 75 72 6e |ine..   |* Return|
|00001a50| 73 20 61 20 73 65 6c 66 | 2d 63 6f 6e 74 61 69 6e |s a self|-contain|
|00001a60| 65 64 20 72 65 66 65 72 | 65 6e 63 65 20 74 6f 20 |ed refer|ence to |
|00001a70| 74 68 65 20 69 6e 73 74 | 61 6e 63 65 27 73 20 63 |the inst|ance's c|
|00001a80| 75 72 72 65 6e 74 0d 20 | 20 20 2a 20 63 6f 6e 66 |urrent. |  * conf|
|00001a90| 69 67 75 72 61 74 69 6f | 6e 2e 0d 20 20 20 2a 20 |iguratio|n..   * |
|00001aa0| 72 65 66 20 6d 75 73 74 | 20 62 65 20 61 20 76 61 |ref must| be a va|
|00001ab0| 6c 69 64 20 6e 6f 6e 2d | 6e 69 6c 20 68 61 6e 64 |lid non-|nil hand|
|00001ac0| 6c 65 20 61 6e 64 20 69 | 74 20 77 69 6c 6c 20 62 |le and i|t will b|
|00001ad0| 65 20 72 65 73 69 7a 65 | 64 20 74 6f 20 66 69 74 |e resize|d to fit|
|00001ae0| 20 74 68 65 0d 20 20 20 | 2a 20 72 65 73 75 6c 74 | the.   |* result|
|00001af0| 69 6e 67 20 64 61 74 61 | 2e 0d 20 20 20 2a 2f 0d |ing data|..   */.|
|00001b00| 0d 70 61 73 63 61 6c 20 | 49 43 45 72 72 6f 72 20 |.pascal |ICError |
|00001b10| 49 43 43 53 65 74 43 6f | 6e 66 69 67 52 65 66 65 |ICCSetCo|nfigRefe|
|00001b20| 72 65 6e 63 65 28 69 6e | 74 65 72 6e 65 74 43 6f |rence(in|ternetCo|
|00001b30| 6e 66 69 67 75 72 61 74 | 69 6f 6e 43 6f 6d 70 6f |nfigurat|ionCompo|
|00001b40| 6e 65 6e 74 20 69 6e 73 | 74 2c 20 49 43 43 6f 6e |nent ins|t, ICCon|
|00001b50| 66 69 67 52 65 66 48 61 | 6e 64 6c 65 20 72 65 66 |figRefHa|ndle ref|
|00001b60| 2c 20 6c 6f 6e 67 20 66 | 6c 61 67 73 29 0d 46 49 |, long f|lags).FI|
|00001b70| 56 45 57 4f 52 44 49 4e | 4c 49 4e 45 28 30 78 32 |VEWORDIN|LINE(0x2|
|00001b80| 46 33 43 2c 20 38 2c 20 | 33 32 2c 20 30 78 37 30 |F3C, 8, |32, 0x70|
|00001b90| 30 30 2c 20 30 78 41 38 | 32 41 29 3b 0d 20 20 2f |00, 0xA8|2A);.  /|
|00001ba0| 2a 20 52 65 71 75 69 72 | 65 73 20 49 43 20 31 2e |* Requir|es IC 1.|
|00001bb0| 32 2e 0d 20 20 20 2a 20 | 49 74 20 69 73 20 69 6c |2..   * |It is il|
|00001bc0| 6c 65 67 61 6c 20 74 6f | 20 63 61 6c 6c 20 74 68 |legal to| call th|
|00001bd0| 69 73 20 72 6f 75 74 69 | 6e 65 20 69 6e 73 69 64 |is routi|ne insid|
|00001be0| 65 20 61 20 49 43 42 65 | 67 69 6e 2f 45 6e 64 20 |e a ICBe|gin/End |
|00001bf0| 70 61 69 72 2e 0d 20 20 | 20 2a 20 52 65 63 6f 6e |pair..  | * Recon|
|00001c00| 66 69 67 75 72 65 73 20 | 74 68 65 20 69 6e 73 74 |figures |the inst|
|00001c10| 61 6e 63 65 20 75 73 69 | 6e 67 20 61 20 63 6f 6e |ance usi|ng a con|
|00001c20| 66 69 67 75 72 61 74 69 | 6f 6e 20 72 65 66 65 72 |figurati|on refer|
|00001c30| 65 6e 63 65 20 74 68 61 | 74 20 77 61 73 0d 20 20 |ence tha|t was.  |
|00001c40| 20 2a 20 67 6f 74 20 75 | 73 69 6e 67 20 49 43 47 | * got u|sing ICG|
|00001c50| 65 74 43 6f 6e 66 69 67 | 52 65 66 65 72 65 6e 63 |etConfig|Referenc|
|00001c60| 65 20 72 65 66 65 72 65 | 6e 63 65 2e 20 53 65 74 |e refere|nce. Set|
|00001c70| 20 74 68 65 0d 20 20 20 | 2a 20 69 63 4e 6f 55 73 | the.   |* icNoUs|
|00001c80| 65 72 49 6e 74 65 72 61 | 63 74 69 6f 6e 5f 62 69 |erIntera|ction_bi|
|00001c90| 74 20 69 6e 20 66 6c 61 | 67 73 20 69 66 20 79 6f |t in fla|gs if yo|
|00001ca0| 75 20 72 65 71 75 69 72 | 65 20 74 68 61 74 20 74 |u requir|e that t|
|00001cb0| 68 69 73 20 72 6f 75 74 | 69 6e 65 0d 20 20 20 2a |his rout|ine.   *|
|00001cc0| 20 6e 6f 74 20 70 72 65 | 73 65 6e 74 20 61 20 6d | not pre|sent a m|
|00001cd0| 6f 64 61 6c 20 64 69 61 | 6c 6f 67 2e 20 4f 74 68 |odal dia|log. Oth|
|00001ce0| 65 72 20 66 6c 61 67 20 | 62 69 74 73 20 61 72 65 |er flag |bits are|
|00001cf0| 20 72 65 73 65 72 76 65 | 64 20 61 6e 64 20 73 68 | reserve|d and sh|
|00001d00| 6f 75 6c 64 0d 20 20 20 | 2a 20 62 65 20 73 65 74 |ould.   |* be set|
|00001d10| 20 74 6f 20 7a 65 72 6f | 2e 0d 20 20 20 2a 20 72 | to zero|..   * r|
|00001d20| 65 66 20 6d 75 73 74 20 | 6e 6f 74 20 62 65 20 6e |ef must |not be n|
|00001d30| 69 6c 2e 0d 20 20 20 2a | 2f 0d 0d 70 61 73 63 61 |il..   *|/..pasca|
|00001d40| 6c 20 49 43 45 72 72 6f | 72 20 49 43 43 53 70 65 |l ICErro|r ICCSpe|
|00001d50| 63 69 66 79 43 6f 6e 66 | 69 67 46 69 6c 65 28 69 |cifyConf|igFile(i|
|00001d60| 6e 74 65 72 6e 65 74 43 | 6f 6e 66 69 67 75 72 61 |nternetC|onfigura|
|00001d70| 74 69 6f 6e 43 6f 6d 70 | 6f 6e 65 6e 74 20 69 6e |tionComp|onent in|
|00001d80| 73 74 2c 20 46 53 53 70 | 65 63 20 2a 63 6f 6e 66 |st, FSSp|ec *conf|
|00001d90| 69 67 29 0d 46 49 56 45 | 57 4f 52 44 49 4e 4c 49 |ig).FIVE|WORDINLI|
|00001da0| 4e 45 28 30 78 32 46 33 | 43 2c 20 34 2c 20 33 2c |NE(0x2F3|C, 4, 3,|
|00001db0| 20 30 78 37 30 30 30 2c | 20 30 78 41 38 32 41 29 | 0x7000,| 0xA82A)|
|00001dc0| 3b 0d 20 20 2f 2a 20 49 | 74 20 69 73 20 69 6c 6c |;.  /* I|t is ill|
|00001dd0| 65 67 61 6c 20 74 6f 20 | 63 61 6c 6c 20 74 68 69 |egal to |call thi|
|00001de0| 73 20 72 6f 75 74 69 6e | 65 20 69 6e 73 69 64 65 |s routin|e inside|
|00001df0| 20 61 20 49 43 42 65 67 | 69 6e 2f 45 6e 64 20 70 | a ICBeg|in/End p|
|00001e00| 61 69 72 2e 0d 20 20 20 | 2a 20 46 6f 72 20 75 73 |air..   |* For us|
|00001e10| 65 20 6f 6e 6c 79 20 62 | 79 20 74 68 65 20 49 43 |e only b|y the IC|
|00001e20| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 2e 0d 20 20 | applica|tion..  |
|00001e30| 20 2a 20 49 66 20 79 6f | 75 20 63 61 6c 6c 20 74 | * If yo|u call t|
|00001e40| 68 69 73 20 72 6f 75 74 | 69 6e 65 20 79 6f 75 72 |his rout|ine your|
|00001e50| 73 65 6c 66 2c 20 79 6f | 75 20 77 69 6c 6c 20 63 |self, yo|u will c|
|00001e60| 6f 6e 66 6c 69 63 74 20 | 77 69 74 68 20 61 6e 79 |onflict |with any|
|00001e70| 0d 20 20 20 2a 20 66 75 | 74 75 72 65 20 49 43 20 |.   * fu|ture IC |
|00001e80| 69 6d 70 6c 65 6d 65 6e | 74 61 74 69 6f 6e 20 74 |implemen|tation t|
|00001e90| 68 61 74 20 64 6f 65 73 | 6e 27 74 20 75 73 65 20 |hat does|n't use |
|00001ea0| 65 78 70 6c 69 63 69 74 | 20 70 72 65 66 65 72 65 |explicit| prefere|
|00001eb0| 6e 63 65 20 66 69 6c 65 | 73 2e 0d 20 20 20 2a 2f |nce file|s..   */|
|00001ec0| 0d 0d 2f 2a 20 2a 2a 2a | 2a 2a 20 47 65 74 74 69 |../* ***|** Getti|
|00001ed0| 6e 67 20 49 6e 66 6f 72 | 6d 61 74 69 6f 6e 20 2a |ng Infor|mation *|
|00001ee0| 2a 2a 2a 2a 20 2a 2f 0d | 0d 70 61 73 63 61 6c 20 |**** */.|.pascal |
|00001ef0| 49 43 45 72 72 6f 72 20 | 49 43 43 47 65 74 53 65 |ICError |ICCGetSe|
|00001f00| 65 64 28 69 6e 74 65 72 | 6e 65 74 43 6f 6e 66 69 |ed(inter|netConfi|
|00001f10| 67 75 72 61 74 69 6f 6e | 43 6f 6d 70 6f 6e 65 6e |guration|Componen|
|00001f20| 74 20 69 6e 73 74 2c 20 | 6c 6f 6e 67 20 2a 73 65 |t inst, |long *se|
|00001f30| 65 64 29 0d 46 49 56 45 | 57 4f 52 44 49 4e 4c 49 |ed).FIVE|WORDINLI|
|00001f40| 4e 45 28 30 78 32 46 33 | 43 2c 20 34 2c 20 34 2c |NE(0x2F3|C, 4, 4,|
|00001f50| 20 30 78 37 30 30 30 2c | 20 30 78 41 38 32 41 29 | 0x7000,| 0xA82A)|
|00001f60| 3b 0d 20 20 2f 2a 20 59 | 6f 75 20 64 6f 20 6e 6f |;.  /* Y|ou do no|
|00001f70| 74 20 68 61 76 65 20 74 | 6f 20 73 70 65 63 69 66 |t have t|o specif|
|00001f80| 79 20 61 20 63 6f 6e 66 | 69 67 75 72 61 74 69 6f |y a conf|iguratio|
|00001f90| 6e 20 62 65 66 6f 72 65 | 20 63 61 6c 6c 69 6e 67 |n before| calling|
|00001fa0| 20 74 68 69 73 20 72 6f | 75 74 69 6e 65 2e 0d 20 | this ro|utine.. |
|00001fb0| 20 20 2a 20 59 6f 75 20 | 64 6f 20 6e 6f 74 20 68 |  * You |do not h|
|00001fc0| 61 76 65 20 74 6f 20 62 | 65 20 69 6e 73 69 64 65 |ave to b|e inside|
|00001fd0| 20 61 6e 20 49 43 42 65 | 67 69 6e 2f 45 6e 64 20 | an ICBe|gin/End |
|00001fe0| 70 61 69 72 20 74 6f 20 | 63 61 6c 6c 20 74 68 69 |pair to |call thi|
|00001ff0| 73 20 72 6f 75 74 69 6e | 65 2e 0d 20 20 20 2a 20 |s routin|e..   * |
|00002000| 52 65 74 75 72 6e 73 20 | 74 68 65 20 63 75 72 72 |Returns |the curr|
|00002010| 65 6e 74 20 73 65 65 64 | 20 66 6f 72 20 74 68 65 |ent seed| for the|
|00002020| 20 49 43 20 70 72 65 66 | 73 20 64 61 74 61 62 61 | IC pref|s databa|
|00002030| 73 65 2e 0d 20 20 20 2a | 20 54 68 69 73 20 73 65 |se..   *| This se|
|00002040| 65 64 20 63 68 61 6e 67 | 65 73 20 65 61 63 68 20 |ed chang|es each |
|00002050| 74 69 6d 65 20 61 20 6e | 6f 6e 2d 76 6f 6c 61 74 |time a n|on-volat|
|00002060| 69 6c 65 20 70 72 65 66 | 65 72 65 6e 63 65 20 69 |ile pref|erence i|
|00002070| 73 20 63 68 61 6e 67 65 | 64 2e 0d 20 20 20 2a 20 |s change|d..   * |
|00002080| 59 6f 75 20 63 61 6e 20 | 70 6f 6c 6c 20 74 68 69 |You can |poll thi|
|00002090| 73 20 74 6f 20 64 65 74 | 65 72 6d 69 6e 65 20 69 |s to det|ermine i|
|000020a0| 66 20 61 6e 79 20 63 61 | 63 68 65 64 20 70 72 65 |f any ca|ched pre|
|000020b0| 66 65 72 65 6e 63 65 73 | 20 63 68 61 6e 67 65 2e |ferences| change.|
|000020c0| 0d 20 20 20 2a 2f 0d 0d | 70 61 73 63 61 6c 20 49 |.   */..|pascal I|
|000020d0| 43 45 72 72 6f 72 20 49 | 43 43 47 65 74 50 65 72 |CError I|CCGetPer|
|000020e0| 6d 28 69 6e 74 65 72 6e | 65 74 43 6f 6e 66 69 67 |m(intern|etConfig|
|000020f0| 75 72 61 74 69 6f 6e 43 | 6f 6d 70 6f 6e 65 6e 74 |urationC|omponent|
|00002100| 20 69 6e 73 74 2c 20 49 | 43 50 65 72 6d 20 2a 70 | inst, I|CPerm *p|
|00002110| 65 72 6d 29 0d 46 49 56 | 45 57 4f 52 44 49 4e 4c |erm).FIV|EWORDINL|
|00002120| 49 4e 45 28 30 78 32 46 | 33 43 2c 20 34 2c 20 31 |INE(0x2F|3C, 4, 1|
|00002130| 33 2c 20 30 78 37 30 30 | 30 2c 20 30 78 41 38 32 |3, 0x700|0, 0xA82|
|00002140| 41 29 3b 0d 20 20 2f 2a | 20 59 6f 75 20 64 6f 20 |A);.  /*| You do |
|00002150| 6e 6f 74 20 68 61 76 65 | 20 74 6f 20 73 70 65 63 |not have| to spec|
|00002160| 69 66 79 20 61 20 63 6f | 6e 66 69 67 75 72 61 74 |ify a co|nfigurat|
|00002170| 69 6f 6e 20 62 65 66 6f | 72 65 20 63 61 6c 6c 69 |ion befo|re calli|
|00002180| 6e 67 20 74 68 69 73 20 | 72 6f 75 74 69 6e 65 2e |ng this |routine.|
|00002190| 0d 20 20 20 2a 20 52 65 | 74 75 72 6e 73 20 74 68 |.   * Re|turns th|
|000021a0| 65 20 61 63 63 65 73 73 | 20 70 65 72 6d 69 73 73 |e access| permiss|
|000021b0| 69 6f 6e 73 20 63 75 72 | 72 65 6e 74 6c 79 20 61 |ions cur|rently a|
|000021c0| 73 73 6f 63 69 61 74 65 | 64 20 77 69 74 68 20 74 |ssociate|d with t|
|000021d0| 68 69 73 20 69 6e 73 74 | 61 6e 63 65 2e 0d 20 20 |his inst|ance..  |
|000021e0| 20 2a 20 57 68 69 6c 65 | 20 61 70 70 6c 69 63 61 | * While| applica|
|000021f0| 74 69 6f 6e 73 20 6e 6f | 72 6d 61 6c 6c 79 20 6b |tions no|rmally k|
|00002200| 6e 6f 77 20 77 68 61 74 | 20 70 65 72 6d 69 73 73 |now what| permiss|
|00002210| 69 6f 6e 73 20 74 68 65 | 79 20 68 61 76 65 2c 0d |ions the|y have,.|
|00002220| 20 20 20 2a 20 74 68 69 | 73 20 72 6f 75 74 69 6e |   * thi|s routin|
|00002230| 65 20 69 73 20 64 65 73 | 69 67 6e 65 64 20 66 6f |e is des|igned fo|
|00002240| 72 20 75 73 65 20 62 79 | 20 6f 76 65 72 72 69 64 |r use by| overrid|
|00002250| 65 20 63 6f 6d 70 6f 6e | 65 6e 74 73 2e 0d 20 20 |e compon|ents..  |
|00002260| 20 2a 2f 0d 0d 70 61 73 | 63 61 6c 20 49 43 45 72 | */..pas|cal ICEr|
|00002270| 72 6f 72 20 49 43 43 44 | 65 66 61 75 6c 74 46 69 |ror ICCD|efaultFi|
|00002280| 6c 65 4e 61 6d 65 28 69 | 6e 74 65 72 6e 65 74 43 |leName(i|nternetC|
|00002290| 6f 6e 66 69 67 75 72 61 | 74 69 6f 6e 43 6f 6d 70 |onfigura|tionComp|
|000022a0| 6f 6e 65 6e 74 20 69 6e | 73 74 2c 20 53 74 72 36 |onent in|st, Str6|
|000022b0| 33 20 6e 61 6d 65 29 0d | 46 49 56 45 57 4f 52 44 |3 name).|FIVEWORD|
|000022c0| 49 4e 4c 49 4e 45 28 30 | 78 32 46 33 43 2c 20 34 |INLINE(0|x2F3C, 4|
|000022d0| 2c 20 31 31 2c 20 30 78 | 37 30 30 30 2c 20 30 78 |, 11, 0x|7000, 0x|
|000022e0| 41 38 32 41 29 3b 0d 20 | 20 2f 2a 20 59 6f 75 20 |A82A);. | /* You |
|000022f0| 64 6f 20 6e 6f 74 20 68 | 61 76 65 20 74 6f 20 73 |do not h|ave to s|
|00002300| 70 65 63 69 66 79 20 61 | 20 63 6f 6e 66 69 67 75 |pecify a| configu|
|00002310| 72 61 74 69 6f 6e 20 62 | 65 66 6f 72 65 20 63 61 |ration b|efore ca|
|00002320| 6c 6c 69 6e 67 20 74 68 | 69 73 20 72 6f 75 74 69 |lling th|is routi|
|00002330| 6e 65 2e 0d 20 20 20 2a | 20 59 6f 75 20 64 6f 20 |ne..   *| You do |
|00002340| 6e 6f 74 20 68 61 76 65 | 20 74 6f 20 62 65 20 69 |not have| to be i|
|00002350| 6e 73 69 64 65 20 61 6e | 20 49 43 42 65 67 69 6e |nside an| ICBegin|
|00002360| 2f 45 6e 64 20 70 61 69 | 72 20 74 6f 20 63 61 6c |/End pai|r to cal|
|00002370| 6c 20 74 68 69 73 20 72 | 6f 75 74 69 6e 65 2e 0d |l this r|outine..|
|00002380| 20 20 20 2a 20 52 65 74 | 75 72 6e 73 20 74 68 65 |   * Ret|urns the|
|00002390| 20 64 65 66 61 75 6c 74 | 20 66 69 6c 65 20 6e 61 | default| file na|
|000023a0| 6d 65 20 66 6f 72 20 49 | 43 20 70 72 65 66 65 72 |me for I|C prefer|
|000023b0| 65 6e 63 65 20 66 69 6c | 65 73 2e 0d 20 20 20 2a |ence fil|es..   *|
|000023c0| 20 41 70 70 6c 69 63 61 | 74 69 6f 6e 73 20 73 68 | Applica|tions sh|
|000023d0| 6f 75 6c 64 20 6e 65 76 | 65 72 20 6e 65 65 64 20 |ould nev|er need |
|000023e0| 74 6f 20 63 61 6c 6c 20 | 74 68 69 73 20 72 6f 75 |to call |this rou|
|000023f0| 74 69 6e 65 2e 0d 20 20 | 20 2a 20 49 66 20 79 6f |tine..  | * If yo|
|00002400| 75 20 72 65 6c 79 20 6f | 6e 20 69 6e 66 6f 72 6d |u rely o|n inform|
|00002410| 61 74 69 6f 6e 20 72 65 | 74 75 72 6e 65 64 20 62 |ation re|turned b|
|00002420| 79 20 74 68 69 73 20 72 | 6f 75 74 69 6e 65 20 79 |y this r|outine y|
|00002430| 6f 75 72 73 65 6c 66 2c | 0d 20 20 20 2a 20 79 6f |ourself,|.   * yo|
|00002440| 75 20 6d 61 79 20 63 6f | 6e 66 6c 69 63 74 20 77 |u may co|nflict w|
|00002450| 69 74 68 20 61 6e 79 20 | 66 75 74 75 72 65 20 49 |ith any |future I|
|00002460| 43 20 69 6d 70 6c 65 6d | 65 6e 74 61 74 69 6f 6e |C implem|entation|
|00002470| 20 74 68 61 74 20 64 6f | 65 73 6e 27 74 20 75 73 | that do|esn't us|
|00002480| 65 0d 20 20 20 2a 20 65 | 78 70 6c 69 63 69 74 20 |e.   * e|xplicit |
|00002490| 70 72 65 66 65 72 65 6e | 63 65 20 66 69 6c 65 73 |preferen|ce files|
|000024a0| 2e 0d 20 20 20 2a 20 54 | 68 65 20 63 6f 6d 70 6f |..   * T|he compo|
|000024b0| 6e 65 6e 74 20 63 61 6c | 6c 73 20 74 68 69 73 20 |nent cal|ls this |
|000024c0| 72 6f 75 74 69 6e 65 20 | 74 6f 20 73 65 74 20 75 |routine |to set u|
|000024d0| 70 20 74 68 65 20 64 65 | 66 61 75 6c 74 20 49 43 |p the de|fault IC|
|000024e0| 20 66 69 6c 65 20 6e 61 | 6d 65 2e 0d 20 20 20 2a | file na|me..   *|
|000024f0| 20 54 68 69 73 20 61 6c | 6c 6f 77 73 20 74 68 69 | This al|lows thi|
|00002500| 73 20 6f 70 65 72 61 74 | 69 6f 6e 20 74 6f 20 62 |s operat|ion to b|
|00002510| 65 20 69 6e 74 65 72 63 | 65 70 74 65 64 20 62 79 |e interc|epted by|
|00002520| 20 61 20 63 6f 6d 70 6f | 6e 65 6e 74 20 74 68 61 | a compo|nent tha|
|00002530| 74 20 68 61 73 0d 20 20 | 20 2a 20 63 61 70 74 75 |t has.  | * captu|
|00002540| 72 65 64 20 75 73 2e 20 | 49 74 20 63 75 72 72 65 |red us. |It curre|
|00002550| 6e 74 6c 79 20 67 65 74 | 73 20 69 74 20 66 72 6f |ntly get|s it fro|
|00002560| 6d 20 74 68 65 20 63 6f | 6d 70 6f 6e 65 6e 74 20 |m the co|mponent |
|00002570| 72 65 73 6f 75 72 63 65 | 20 66 69 6c 65 2e 0d 20 |resource| file.. |
|00002580| 20 20 2a 20 54 68 65 20 | 67 6c 75 65 20 76 65 72 |  * The |glue ver|
|00002590| 73 69 6f 6e 20 69 73 20 | 68 61 72 64 77 69 72 65 |sion is |hardwire|
|000025a0| 64 20 74 6f 20 22 49 6e | 74 65 72 6e 65 74 20 50 |d to "In|ternet P|
|000025b0| 72 65 66 65 72 65 6e 63 | 65 73 22 2e 0d 20 20 20 |referenc|es"..   |
|000025c0| 2a 2f 0d 0d 2f 2a 20 2a | 2a 2a 2a 2a 20 52 65 61 |*/../* *|**** Rea|
|000025d0| 64 69 6e 67 20 61 6e 64 | 20 57 72 69 74 69 6e 67 |ding and| Writing|
|000025e0| 20 50 72 65 66 65 72 65 | 6e 63 65 73 20 2a 2a 2a | Prefere|nces ***|
|000025f0| 2a 2a 20 2a 2f 0d 0d 70 | 61 73 63 61 6c 20 49 43 |** */..p|ascal IC|
|00002600| 45 72 72 6f 72 20 49 43 | 43 42 65 67 69 6e 28 69 |Error IC|CBegin(i|
|00002610| 6e 74 65 72 6e 65 74 43 | 6f 6e 66 69 67 75 72 61 |nternetC|onfigura|
|00002620| 74 69 6f 6e 43 6f 6d 70 | 6f 6e 65 6e 74 20 69 6e |tionComp|onent in|
|00002630| 73 74 2c 20 49 43 50 65 | 72 6d 20 70 65 72 6d 29 |st, ICPe|rm perm)|
|00002640| 0d 46 49 56 45 57 4f 52 | 44 49 4e 4c 49 4e 45 28 |.FIVEWOR|DINLINE(|
|00002650| 30 78 32 46 33 43 2c 20 | 32 2c 20 35 2c 20 30 78 |0x2F3C, |2, 5, 0x|
|00002660| 37 30 30 30 2c 20 30 78 | 41 38 32 41 29 3b 0d 20 |7000, 0x|A82A);. |
|00002670| 20 2f 2a 20 59 6f 75 20 | 6d 75 73 74 20 73 70 65 | /* You |must spe|
|00002680| 63 69 66 79 20 61 20 63 | 6f 6e 66 69 67 75 72 61 |cify a c|onfigura|
|00002690| 74 69 6f 6e 20 62 65 66 | 6f 72 65 20 63 61 6c 6c |tion bef|ore call|
|000026a0| 69 6e 67 20 74 68 69 73 | 20 72 6f 75 74 69 6e 65 |ing this| routine|
|000026b0| 2e 0d 20 20 20 2a 20 49 | 74 20 69 73 20 69 6c 6c |..   * I|t is ill|
|000026c0| 65 67 61 6c 20 74 6f 20 | 63 61 6c 6c 20 74 68 69 |egal to |call thi|
|000026d0| 73 20 72 6f 75 74 69 6e | 65 20 69 6e 73 69 64 65 |s routin|e inside|
|000026e0| 20 61 20 49 43 42 65 67 | 69 6e 2f 45 6e 64 20 70 | a ICBeg|in/End p|
|000026f0| 61 69 72 2e 0d 20 20 20 | 2a 20 53 74 61 72 74 69 |air..   |* Starti|
|00002700| 6e 67 20 72 65 61 64 69 | 6e 67 20 6f 72 20 77 72 |ng readi|ng or wr|
|00002710| 69 74 69 6e 67 20 6d 75 | 6c 74 69 70 6c 65 20 70 |iting mu|ltiple p|
|00002720| 72 65 66 65 72 65 6e 63 | 65 73 2e 0d 20 20 20 2a |referenc|es..   *|
|00002730| 20 41 20 63 61 6c 6c 20 | 74 6f 20 74 68 69 73 20 | A call |to this |
|00002740| 6d 75 73 74 20 62 65 20 | 62 61 6c 61 6e 63 65 64 |must be |balanced|
|00002750| 20 62 79 20 61 20 63 61 | 6c 6c 20 74 6f 20 49 43 | by a ca|ll to IC|
|00002760| 45 6e 64 2e 0d 20 20 20 | 2a 20 44 6f 20 6e 6f 74 |End..   |* Do not|
|00002770| 20 63 61 6c 6c 20 57 61 | 69 74 4e 65 78 74 45 76 | call Wa|itNextEv|
|00002780| 65 6e 74 20 62 65 74 77 | 65 65 6e 20 74 68 65 73 |ent betw|een thes|
|00002790| 65 20 63 61 6c 6c 73 2e | 0d 20 20 20 2a 20 54 68 |e calls.|.   * Th|
|000027a0| 65 20 70 65 72 6d 20 73 | 70 65 63 69 66 69 65 73 |e perm s|pecifies|
|000027b0| 20 77 68 65 74 68 65 72 | 20 79 6f 75 20 69 6e 74 | whether| you int|
|000027c0| 65 6e 64 20 74 6f 20 72 | 65 61 64 20 6f 72 20 72 |end to r|ead or r|
|000027d0| 65 61 64 2f 77 72 69 74 | 65 2e 0d 20 20 20 2a 20 |ead/writ|e..   * |
|000027e0| 4f 6e 6c 79 20 6f 6e 65 | 20 77 72 69 74 65 72 20 |Only one| writer |
|000027f0| 69 73 20 61 6c 6c 6f 77 | 65 64 20 70 65 72 20 69 |is allow|ed per i|
|00002800| 6e 73 74 61 6e 63 65 2e | 0d 20 20 20 2a 20 4e 6f |nstance.|.   * No|
|00002810| 74 65 20 74 68 61 74 20 | 74 68 69 73 20 6d 61 79 |te that |this may|
|00002820| 20 6f 70 65 6e 20 72 65 | 73 6f 75 72 63 65 20 66 | open re|source f|
|00002830| 69 6c 65 73 20 74 68 61 | 74 20 61 72 65 20 6e 6f |iles tha|t are no|
|00002840| 74 20 63 6c 6f 73 65 64 | 0d 20 20 20 2a 20 75 6e |t closed|.   * un|
|00002850| 74 69 6c 20 79 6f 75 20 | 63 61 6c 6c 20 49 43 45 |til you |call ICE|
|00002860| 6e 64 2e 0d 20 20 20 2a | 2f 0d 0d 70 61 73 63 61 |nd..   *|/..pasca|
|00002870| 6c 20 49 43 45 72 72 6f | 72 20 49 43 43 47 65 74 |l ICErro|r ICCGet|
|00002880| 50 72 65 66 28 69 6e 74 | 65 72 6e 65 74 43 6f 6e |Pref(int|ernetCon|
|00002890| 66 69 67 75 72 61 74 69 | 6f 6e 43 6f 6d 70 6f 6e |figurati|onCompon|
|000028a0| 65 6e 74 20 69 6e 73 74 | 2c 20 43 6f 6e 73 74 53 |ent inst|, ConstS|
|000028b0| 74 72 32 35 35 50 61 72 | 61 6d 20 6b 65 79 2c 20 |tr255Par|am key, |
|000028c0| 49 43 41 74 74 72 20 2a | 61 74 74 72 2c 20 50 74 |ICAttr *|attr, Pt|
|000028d0| 72 20 62 75 66 2c 20 6c | 6f 6e 67 20 2a 73 69 7a |r buf, l|ong *siz|
|000028e0| 65 29 0d 46 49 56 45 57 | 4f 52 44 49 4e 4c 49 4e |e).FIVEW|ORDINLIN|
|000028f0| 45 28 30 78 32 46 33 43 | 2c 20 31 36 2c 20 36 2c |E(0x2F3C|, 16, 6,|
|00002900| 20 30 78 37 30 30 30 2c | 20 30 78 41 38 32 41 29 | 0x7000,| 0xA82A)|
|00002910| 3b 0d 20 20 2f 2a 20 59 | 6f 75 20 6d 75 73 74 20 |;.  /* Y|ou must |
|00002920| 73 70 65 63 69 66 79 20 | 61 20 63 6f 6e 66 69 67 |specify |a config|
|00002930| 75 72 61 74 69 6f 6e 20 | 62 65 66 6f 72 65 20 63 |uration |before c|
|00002940| 61 6c 6c 69 6e 67 20 74 | 68 69 73 20 72 6f 75 74 |alling t|his rout|
|00002950| 69 6e 65 2e 0d 20 20 20 | 2a 20 49 66 20 79 6f 75 |ine..   |* If you|
|00002960| 20 61 72 65 20 67 65 74 | 74 69 6e 67 20 6f 72 20 | are get|ting or |
|00002970| 73 65 74 74 69 6e 67 20 | 6d 75 6c 74 69 70 6c 65 |setting |multiple|
|00002980| 20 70 72 65 66 65 72 65 | 6e 63 65 73 2c 20 79 6f | prefere|nces, yo|
|00002990| 75 20 73 68 6f 75 6c 64 | 20 70 6c 61 63 65 0d 20 |u should| place. |
|000029a0| 20 20 2a 20 74 68 65 73 | 65 20 63 61 6c 6c 73 20 |  * thes|e calls |
|000029b0| 77 69 74 68 69 6e 20 61 | 6e 20 49 43 42 65 67 69 |within a|n ICBegi|
|000029c0| 6e 2f 49 43 45 6e 64 20 | 70 61 69 72 2e 0d 20 20 |n/ICEnd |pair..  |
|000029d0| 20 2a 20 49 66 20 79 6f | 75 20 63 61 6c 6c 20 74 | * If yo|u call t|
|000029e0| 68 69 73 20 72 6f 75 74 | 69 6e 65 20 6f 75 74 73 |his rout|ine outs|
|000029f0| 69 64 65 20 6f 66 20 73 | 75 63 68 20 61 20 70 61 |ide of s|uch a pa|
|00002a00| 69 72 2c 20 69 74 20 69 | 6d 70 6c 69 63 69 74 6c |ir, it i|mplicitl|
|00002a10| 79 0d 20 20 20 2a 20 63 | 61 6c 6c 73 20 49 43 42 |y.   * c|alls ICB|
|00002a20| 65 67 69 6e 28 69 6e 73 | 74 2c 20 69 63 52 65 61 |egin(ins|t, icRea|
|00002a30| 64 4f 6e 6c 79 50 65 72 | 6d 29 2e 0d 20 20 20 2a |dOnlyPer|m)..   *|
|00002a40| 20 52 65 61 64 73 20 74 | 68 65 20 70 72 65 66 65 | Reads t|he prefe|
|00002a50| 72 65 6e 63 65 20 73 70 | 65 63 69 66 69 65 64 20 |rence sp|ecified |
|00002a60| 62 79 20 6b 65 79 20 66 | 72 6f 6d 20 74 68 65 20 |by key f|rom the |
|00002a70| 49 43 20 64 61 74 61 62 | 61 73 65 20 74 6f 20 74 |IC datab|ase to t|
|00002a80| 68 65 0d 20 20 20 2a 20 | 62 75 66 66 65 72 20 70 |he.   * |buffer p|
|00002a90| 6f 69 6e 74 65 64 20 74 | 6f 20 62 79 20 62 75 66 |ointed t|o by buf|
|00002aa0| 20 61 6e 64 20 73 69 7a | 65 2e 0d 20 20 20 2a 20 | and siz|e..   * |
|00002ab0| 6b 65 79 20 6d 75 73 74 | 20 6e 6f 74 20 62 65 20 |key must| not be |
|00002ac0| 74 68 65 20 65 6d 70 74 | 79 20 73 74 72 69 6e 67 |the empt|y string|
|00002ad0| 2e 0d 20 20 20 2a 20 49 | 66 20 62 75 66 20 69 73 |..   * I|f buf is|
|00002ae0| 20 6e 69 6c 20 74 68 65 | 6e 20 6e 6f 20 64 61 74 | nil the|n no dat|
|00002af0| 61 20 69 73 20 72 65 74 | 75 72 6e 65 64 2e 0d 20 |a is ret|urned.. |
|00002b00| 20 20 2a 20 73 69 7a 65 | 20 6d 75 73 74 20 62 65 |  * size| must be|
|00002b10| 20 6e 6f 6e 2d 6e 65 67 | 61 74 69 76 65 2e 0d 20 | non-neg|ative.. |
|00002b20| 20 20 2a 20 61 74 74 72 | 20 61 6e 64 20 73 69 7a |  * attr| and siz|
|00002b30| 65 20 61 72 65 20 61 6c | 77 61 79 73 20 73 65 74 |e are al|ways set|
|00002b40| 20 6f 6e 20 72 65 74 75 | 72 6e 2e 20 4f 6e 20 65 | on retu|rn. On e|
|00002b50| 72 72 6f 72 73 20 28 65 | 78 63 65 70 74 20 69 63 |rrors (e|xcept ic|
|00002b60| 54 72 75 6e 63 61 74 65 | 64 45 72 72 29 0d 20 20 |Truncate|dErr).  |
|00002b70| 20 2a 20 61 74 74 72 20 | 69 73 20 73 65 74 20 74 | * attr |is set t|
|00002b80| 6f 20 49 43 61 74 74 72 | 5f 6e 6f 5f 63 68 61 6e |o ICattr|_no_chan|
|00002b90| 67 65 20 61 6e 64 20 73 | 69 7a 65 20 69 73 20 73 |ge and s|ize is s|
|00002ba0| 65 74 20 74 6f 20 30 2e | 0d 20 20 20 2a 20 73 69 |et to 0.|.   * si|
|00002bb0| 7a 65 20 69 73 20 74 68 | 65 20 61 63 74 75 61 6c |ze is th|e actual|
|00002bc0| 20 73 69 7a 65 20 6f 66 | 20 74 68 65 20 64 61 74 | size of| the dat|
|00002bd0| 61 2e 0d 20 20 20 2a 20 | 61 74 74 72 20 69 73 20 |a..   * |attr is |
|00002be0| 73 65 74 20 74 6f 20 74 | 68 65 20 61 74 74 72 69 |set to t|he attri|
|00002bf0| 62 75 74 65 73 20 61 73 | 73 6f 63 69 61 74 65 64 |butes as|sociated|
|00002c00| 20 77 69 74 68 20 74 68 | 65 20 70 72 65 66 65 72 | with th|e prefer|
|00002c10| 65 6e 63 65 2e 0d 20 20 | 20 2a 20 49 66 20 74 68 |ence..  | * If th|
|00002c20| 69 73 20 72 6f 75 74 69 | 6e 65 20 72 65 74 75 72 |is routi|ne retur|
|00002c30| 6e 73 20 69 63 54 72 75 | 6e 63 61 74 65 64 45 72 |ns icTru|ncatedEr|
|00002c40| 72 20 74 68 65 6e 20 74 | 68 65 20 6f 74 68 65 72 |r then t|he other|
|00002c50| 20 72 65 74 75 72 6e 65 | 64 0d 20 20 20 2a 20 76 | returne|d.   * v|
|00002c60| 61 6c 75 65 73 20 61 72 | 65 20 76 61 6c 69 64 20 |alues ar|e valid |
|00002c70| 65 78 63 65 70 74 20 74 | 68 61 74 20 6f 6e 6c 79 |except t|hat only|
|00002c80| 20 74 68 65 20 66 69 72 | 73 74 20 73 69 7a 65 20 | the fir|st size |
|00002c90| 62 79 74 65 73 20 68 61 | 76 65 20 62 65 65 6e 0d |bytes ha|ve been.|
|00002ca0| 20 20 20 2a 20 72 65 74 | 75 72 6e 2e 20 73 69 7a |   * ret|urn. siz|
|00002cb0| 65 20 69 73 20 61 64 6a | 75 73 74 65 64 20 74 6f |e is adj|usted to|
|00002cc0| 20 72 65 66 6c 65 63 74 | 20 74 68 65 20 74 72 75 | reflect| the tru|
|00002cd0| 65 20 73 69 7a 65 20 6f | 66 20 74 68 65 20 70 72 |e size o|f the pr|
|00002ce0| 65 66 65 72 65 6e 63 65 | 2e 0d 20 20 20 2a 20 52 |eference|..   * R|
|00002cf0| 65 74 75 72 6e 73 20 69 | 63 50 72 65 66 4e 6f 74 |eturns i|cPrefNot|
|00002d00| 46 6f 75 6e 64 20 69 66 | 20 74 68 65 72 65 20 69 |Found if| there i|
|00002d10| 73 20 6e 6f 20 70 72 65 | 66 65 72 65 6e 63 65 20 |s no pre|ference |
|00002d20| 66 6f 72 20 74 68 65 20 | 6b 65 79 2e 0d 20 20 20 |for the |key..   |
|00002d30| 2a 2f 0d 0d 70 61 73 63 | 61 6c 20 49 43 45 72 72 |*/..pasc|al ICErr|
|00002d40| 6f 72 20 49 43 43 53 65 | 74 50 72 65 66 28 69 6e |or ICCSe|tPref(in|
|00002d50| 74 65 72 6e 65 74 43 6f | 6e 66 69 67 75 72 61 74 |ternetCo|nfigurat|
|00002d60| 69 6f 6e 43 6f 6d 70 6f | 6e 65 6e 74 20 69 6e 73 |ionCompo|nent ins|
|00002d70| 74 2c 20 43 6f 6e 73 74 | 53 74 72 32 35 35 50 61 |t, Const|Str255Pa|
|00002d80| 72 61 6d 20 6b 65 79 2c | 20 49 43 41 74 74 72 20 |ram key,| ICAttr |
|00002d90| 61 74 74 72 2c 20 50 74 | 72 20 62 75 66 2c 20 6c |attr, Pt|r buf, l|
|00002da0| 6f 6e 67 20 73 69 7a 65 | 29 0d 46 49 56 45 57 4f |ong size|).FIVEWO|
|00002db0| 52 44 49 4e 4c 49 4e 45 | 28 30 78 32 46 33 43 2c |RDINLINE|(0x2F3C,|
|00002dc0| 20 31 36 2c 20 37 2c 20 | 30 78 37 30 30 30 2c 20 | 16, 7, |0x7000, |
|00002dd0| 30 78 41 38 32 41 29 3b | 0d 20 20 2f 2a 20 59 6f |0xA82A);|.  /* Yo|
|00002de0| 75 20 6d 75 73 74 20 73 | 70 65 63 69 66 79 20 61 |u must s|pecify a|
|00002df0| 20 63 6f 6e 66 69 67 75 | 72 61 74 69 6f 6e 20 62 | configu|ration b|
|00002e00| 65 66 6f 72 65 20 63 61 | 6c 6c 69 6e 67 20 74 68 |efore ca|lling th|
|00002e10| 69 73 20 72 6f 75 74 69 | 6e 65 2e 0d 20 20 20 2a |is routi|ne..   *|
|00002e20| 20 49 66 20 79 6f 75 20 | 61 72 65 20 67 65 74 74 | If you |are gett|
|00002e30| 69 6e 67 20 6f 72 20 73 | 65 74 74 69 6e 67 20 6d |ing or s|etting m|
|00002e40| 75 6c 74 69 70 6c 65 20 | 70 72 65 66 65 72 65 6e |ultiple |preferen|
|00002e50| 63 65 73 2c 20 79 6f 75 | 20 73 68 6f 75 6c 64 20 |ces, you| should |
|00002e60| 70 6c 61 63 65 0d 20 20 | 20 2a 20 74 68 65 73 65 |place.  | * these|
|00002e70| 20 63 61 6c 6c 73 20 77 | 69 74 68 69 6e 20 61 6e | calls w|ithin an|
|00002e80| 20 49 43 42 65 67 69 6e | 2f 49 43 45 6e 64 20 70 | ICBegin|/ICEnd p|
|00002e90| 61 69 72 2e 0d 20 20 20 | 2a 20 49 66 20 79 6f 75 |air..   |* If you|
|00002ea0| 20 63 61 6c 6c 20 74 68 | 69 73 20 72 6f 75 74 69 | call th|is routi|
|00002eb0| 6e 65 20 6f 75 74 73 69 | 64 65 20 6f 66 20 73 75 |ne outsi|de of su|
|00002ec0| 63 68 20 61 20 70 61 69 | 72 2c 20 69 74 20 69 6d |ch a pai|r, it im|
|00002ed0| 70 6c 69 63 69 74 6c 79 | 0d 20 20 20 2a 20 63 61 |plicitly|.   * ca|
|00002ee0| 6c 6c 73 20 49 43 42 65 | 67 69 6e 28 69 6e 73 74 |lls ICBe|gin(inst|
|00002ef0| 2c 20 69 63 52 65 61 64 | 57 72 69 74 65 50 65 72 |, icRead|WritePer|
|00002f00| 6d 29 2e 0d 20 20 20 2a | 20 53 65 74 73 20 74 68 |m)..   *| Sets th|
|00002f10| 65 20 70 72 65 66 65 72 | 65 6e 63 65 20 73 70 65 |e prefer|ence spe|
|00002f20| 63 69 66 69 65 64 20 62 | 79 20 6b 65 79 20 66 72 |cified b|y key fr|
|00002f30| 6f 6d 20 74 68 65 20 49 | 43 20 64 61 74 61 62 61 |om the I|C databa|
|00002f40| 73 65 20 74 6f 20 74 68 | 65 0d 20 20 20 2a 20 76 |se to th|e.   * v|
|00002f50| 61 6c 75 65 20 70 6f 69 | 6e 74 65 64 20 74 6f 20 |alue poi|nted to |
|00002f60| 62 79 20 62 75 66 20 61 | 6e 64 20 73 69 7a 65 2e |by buf a|nd size.|
|00002f70| 0d 20 20 20 2a 20 6b 65 | 79 20 6d 75 73 74 20 6e |.   * ke|y must n|
|00002f80| 6f 74 20 62 65 20 74 68 | 65 20 65 6d 70 74 79 20 |ot be th|e empty |
|00002f90| 73 74 72 69 6e 67 2e 0d | 20 20 20 2a 20 73 69 7a |string..|   * siz|
|00002fa0| 65 20 6d 75 73 74 20 62 | 65 20 6e 6f 6e 2d 6e 65 |e must b|e non-ne|
|00002fb0| 67 61 74 69 76 65 2e 20 | 0d 20 20 20 2a 20 49 66 |gative. |.   * If|
|00002fc0| 20 62 75 66 20 69 73 20 | 6e 69 6c 20 74 68 65 6e | buf is |nil then|
|00002fd0| 20 74 68 65 20 70 72 65 | 66 65 72 65 6e 63 65 20 | the pre|ference |
|00002fe0| 76 61 6c 75 65 20 69 73 | 20 6e 6f 74 20 73 65 74 |value is| not set|
|00002ff0| 20 61 6e 64 20 73 69 7a | 65 20 69 73 20 69 67 6e | and siz|e is ign|
|00003000| 6f 72 65 64 2e 0d 20 20 | 20 2a 20 49 66 20 62 75 |ored..  | * If bu|
|00003010| 66 20 69 73 20 6e 6f 74 | 20 6e 69 6c 20 74 68 65 |f is not| nil the|
|00003020| 6e 20 74 68 65 20 70 72 | 65 66 65 72 65 6e 63 65 |n the pr|eference|
|00003030| 20 76 61 6c 75 65 20 69 | 73 20 73 65 74 20 74 6f | value i|s set to|
|00003040| 20 74 68 65 20 73 69 7a | 65 0d 20 20 20 2a 20 62 | the siz|e.   * b|
|00003050| 79 74 65 73 20 70 6f 69 | 6e 74 65 64 20 74 6f 20 |ytes poi|nted to |
|00003060| 62 79 20 62 75 66 2e 0d | 20 20 20 2a 20 49 66 20 |by buf..|   * If |
|00003070| 61 74 74 72 20 69 73 20 | 49 43 61 74 74 72 5f 6e |attr is |ICattr_n|
|00003080| 6f 5f 63 68 61 6e 67 65 | 20 74 68 65 6e 20 74 68 |o_change| then th|
|00003090| 65 20 70 72 65 66 65 72 | 65 6e 63 65 20 61 74 74 |e prefer|ence att|
|000030a0| 72 69 62 75 74 65 73 20 | 61 72 65 20 6e 6f 74 20 |ributes |are not |
|000030b0| 73 65 74 2e 0d 20 20 20 | 2a 20 4f 74 68 65 72 77 |set..   |* Otherw|
|000030c0| 69 73 65 20 74 68 65 20 | 70 72 65 66 65 72 65 6e |ise the |preferen|
|000030d0| 63 65 20 61 74 74 72 69 | 62 75 74 65 73 20 61 72 |ce attri|butes ar|
|000030e0| 65 20 73 65 74 20 74 6f | 20 61 74 74 72 2e 0d 20 |e set to| attr.. |
|000030f0| 20 20 2a 20 52 65 74 75 | 72 6e 73 20 69 63 50 65 |  * Retu|rns icPe|
|00003100| 72 6d 45 72 72 20 69 66 | 20 74 68 65 20 70 72 65 |rmErr if| the pre|
|00003110| 76 69 6f 75 73 20 49 43 | 42 65 67 69 6e 20 77 61 |vious IC|Begin wa|
|00003120| 73 20 70 61 73 73 65 64 | 20 69 63 52 65 61 64 4f |s passed| icReadO|
|00003130| 6e 6c 79 50 65 72 6d 2e | 0d 20 20 20 2a 20 52 65 |nlyPerm.|.   * Re|
|00003140| 74 75 72 6e 73 20 69 63 | 50 65 72 6d 45 72 72 20 |turns ic|PermErr |
|00003150| 69 66 20 63 75 72 72 65 | 6e 74 20 61 74 74 72 20 |if curre|nt attr |
|00003160| 69 73 20 6c 6f 63 6b 65 | 64 2c 20 6e 65 77 20 61 |is locke|d, new a|
|00003170| 74 74 72 20 69 73 20 6c | 6f 63 6b 65 64 20 61 6e |ttr is l|ocked an|
|00003180| 64 20 62 75 66 20 3c 3e | 20 6e 69 6c 2e 0d 20 20 |d buf <>| nil..  |
|00003190| 20 2a 2f 0d 0d 70 61 73 | 63 61 6c 20 49 43 45 72 | */..pas|cal ICEr|
|000031a0| 72 6f 72 20 49 43 43 46 | 69 6e 64 50 72 65 66 48 |ror ICCF|indPrefH|
|000031b0| 61 6e 64 6c 65 28 69 6e | 74 65 72 6e 65 74 43 6f |andle(in|ternetCo|
|000031c0| 6e 66 69 67 75 72 61 74 | 69 6f 6e 43 6f 6d 70 6f |nfigurat|ionCompo|
|000031d0| 6e 65 6e 74 20 69 6e 73 | 74 2c 20 43 6f 6e 73 74 |nent ins|t, Const|
|000031e0| 53 74 72 32 35 35 50 61 | 72 61 6d 20 6b 65 79 2c |Str255Pa|ram key,|
|000031f0| 20 49 43 41 74 74 72 20 | 2a 61 74 74 72 2c 20 48 | ICAttr |*attr, H|
|00003200| 61 6e 64 6c 65 20 70 72 | 65 66 68 29 0d 46 49 56 |andle pr|efh).FIV|
|00003210| 45 57 4f 52 44 49 4e 4c | 49 4e 45 28 30 78 32 46 |EWORDINL|INE(0x2F|
|00003220| 33 43 2c 20 31 32 2c 20 | 33 36 2c 20 30 78 37 30 |3C, 12, |36, 0x70|
|00003230| 30 30 2c 20 30 78 41 38 | 32 41 29 3b 0d 20 20 2f |00, 0xA8|2A);.  /|
|00003240| 2a 20 52 65 71 75 69 72 | 65 73 20 49 43 20 31 2e |* Requir|es IC 1.|
|00003250| 32 2e 0d 20 20 20 2a 20 | 59 6f 75 20 6d 75 73 74 |2..   * |You must|
|00003260| 20 73 70 65 63 69 66 79 | 20 61 20 63 6f 6e 66 69 | specify| a confi|
|00003270| 67 75 72 61 74 69 6f 6e | 20 62 65 66 6f 72 65 20 |guration| before |
|00003280| 63 61 6c 6c 69 6e 67 20 | 74 68 69 73 20 72 6f 75 |calling |this rou|
|00003290| 74 69 6e 65 2e 0d 20 20 | 20 2a 20 49 66 20 79 6f |tine..  | * If yo|
|000032a0| 75 20 61 72 65 20 67 65 | 74 74 69 6e 67 20 6f 72 |u are ge|tting or|
|000032b0| 20 73 65 74 74 69 6e 67 | 20 6d 75 6c 74 69 70 6c | setting| multipl|
|000032c0| 65 20 70 72 65 66 65 72 | 65 6e 63 65 73 2c 20 79 |e prefer|ences, y|
|000032d0| 6f 75 20 73 68 6f 75 6c | 64 20 70 6c 61 63 65 0d |ou shoul|d place.|
|000032e0| 20 20 20 2a 20 74 68 65 | 73 65 20 63 61 6c 6c 73 |   * the|se calls|
|000032f0| 20 77 69 74 68 69 6e 20 | 61 6e 20 49 43 42 65 67 | within |an ICBeg|
|00003300| 69 6e 2f 49 43 45 6e 64 | 20 70 61 69 72 2e 0d 20 |in/ICEnd| pair.. |
|00003310| 20 20 2a 20 49 66 20 79 | 6f 75 20 63 61 6c 6c 20 |  * If y|ou call |
|00003320| 74 68 69 73 20 72 6f 75 | 74 69 6e 65 20 6f 75 74 |this rou|tine out|
|00003330| 73 69 64 65 20 6f 66 20 | 73 75 63 68 20 61 20 70 |side of |such a p|
|00003340| 61 69 72 2c 20 69 74 20 | 69 6d 70 6c 69 63 69 74 |air, it |implicit|
|00003350| 6c 79 0d 20 20 20 2a 20 | 63 61 6c 6c 73 20 49 43 |ly.   * |calls IC|
|00003360| 42 65 67 69 6e 28 69 6e | 73 74 2c 20 69 63 52 65 |Begin(in|st, icRe|
|00003370| 61 64 57 72 69 74 65 50 | 65 72 6d 29 2e 0d 20 20 |adWriteP|erm)..  |
|00003380| 20 2a 20 54 68 69 73 20 | 72 6f 75 74 69 6e 65 20 | * This |routine |
|00003390| 65 66 66 65 63 74 69 76 | 65 6c 79 20 72 65 70 6c |effectiv|ely repl|
|000033a0| 61 63 65 73 20 49 43 47 | 65 74 50 72 65 66 48 61 |aces ICG|etPrefHa|
|000033b0| 6e 64 6c 65 2e 0d 20 20 | 20 2a 20 52 65 61 64 73 |ndle..  | * Reads|
|000033c0| 20 74 68 65 20 70 72 65 | 66 65 72 65 6e 63 65 20 | the pre|ference |
|000033d0| 73 70 65 63 69 66 69 65 | 64 20 62 79 20 6b 65 79 |specifie|d by key|
|000033e0| 20 66 72 6f 6d 20 74 68 | 65 20 49 43 20 64 61 74 | from th|e IC dat|
|000033f0| 61 62 61 73 65 20 69 6e | 74 6f 0d 20 20 20 2a 20 |abase in|to.   * |
|00003400| 61 20 68 61 6e 64 6c 65 | 2c 20 70 72 65 66 68 2e |a handle|, prefh.|
|00003410| 0d 20 20 20 2a 20 6b 65 | 79 20 6d 75 73 74 20 6e |.   * ke|y must n|
|00003420| 6f 74 20 62 65 20 74 68 | 65 20 65 6d 70 74 79 20 |ot be th|e empty |
|00003430| 73 74 72 69 6e 67 2e 0d | 20 20 20 2a 20 61 74 74 |string..|   * att|
|00003440| 72 20 69 73 20 73 65 74 | 20 74 6f 20 74 68 65 20 |r is set| to the |
|00003450| 61 74 74 72 69 62 75 74 | 65 73 20 61 73 73 6f 63 |attribut|es assoc|
|00003460| 69 61 74 65 64 20 77 69 | 74 68 20 74 68 65 20 70 |iated wi|th the p|
|00003470| 72 65 66 65 72 65 6e 63 | 65 2e 0d 20 20 20 2a 20 |referenc|e..   * |
|00003480| 59 6f 75 20 6d 75 73 74 | 20 73 65 74 20 70 72 65 |You must| set pre|
|00003490| 66 68 20 74 6f 20 61 20 | 6e 6f 6e 2d 6e 69 6c 20 |fh to a |non-nil |
|000034a0| 68 61 6e 64 6c 65 20 62 | 65 66 6f 72 65 20 63 61 |handle b|efore ca|
|000034b0| 6c 6c 69 6e 67 20 74 68 | 69 73 20 72 6f 75 74 69 |lling th|is routi|
|000034c0| 6e 65 2e 0d 20 20 20 2a | 20 49 66 20 74 68 65 20 |ne..   *| If the |
|000034d0| 70 72 65 66 65 72 65 6e | 63 65 20 64 6f 65 73 20 |preferen|ce does |
|000034e0| 6e 6f 74 20 65 78 69 73 | 74 2c 20 69 63 50 72 65 |not exis|t, icPre|
|000034f0| 66 4e 6f 74 46 6f 75 6e | 64 45 72 72 20 69 73 20 |fNotFoun|dErr is |
|00003500| 72 65 74 75 72 6e 65 64 | 2e 0d 20 20 20 2a 2f 0d |returned|..   */.|
|00003510| 0d 70 61 73 63 61 6c 20 | 49 43 45 72 72 6f 72 20 |.pascal |ICError |
|00003520| 49 43 43 47 65 74 50 72 | 65 66 48 61 6e 64 6c 65 |ICCGetPr|efHandle|
|00003530| 28 69 6e 74 65 72 6e 65 | 74 43 6f 6e 66 69 67 75 |(interne|tConfigu|
|00003540| 72 61 74 69 6f 6e 43 6f | 6d 70 6f 6e 65 6e 74 20 |rationCo|mponent |
|00003550| 69 6e 73 74 2c 20 43 6f | 6e 73 74 53 74 72 32 35 |inst, Co|nstStr25|
|00003560| 35 50 61 72 61 6d 20 6b | 65 79 2c 20 49 43 41 74 |5Param k|ey, ICAt|
|00003570| 74 72 20 2a 61 74 74 72 | 2c 20 48 61 6e 64 6c 65 |tr *attr|, Handle|
|00003580| 20 2a 70 72 65 66 68 29 | 0d 46 49 56 45 57 4f 52 | *prefh)|.FIVEWOR|
|00003590| 44 49 4e 4c 49 4e 45 28 | 30 78 32 46 33 43 2c 20 |DINLINE(|0x2F3C, |
|000035a0| 31 32 2c 20 32 36 2c 20 | 30 78 37 30 30 30 2c 20 |12, 26, |0x7000, |
|000035b0| 30 78 41 38 32 41 29 3b | 0d 20 20 2f 2a 20 52 65 |0xA82A);|.  /* Re|
|000035c0| 71 75 69 72 65 73 20 49 | 43 20 31 2e 31 2e 0d 20 |quires I|C 1.1.. |
|000035d0| 20 20 2a 20 59 6f 75 20 | 6d 75 73 74 20 73 70 65 |  * You |must spe|
|000035e0| 63 69 66 79 20 61 20 63 | 6f 6e 66 69 67 75 72 61 |cify a c|onfigura|
|000035f0| 74 69 6f 6e 20 62 65 66 | 6f 72 65 20 63 61 6c 6c |tion bef|ore call|
|00003600| 69 6e 67 20 74 68 69 73 | 20 72 6f 75 74 69 6e 65 |ing this| routine|
|00003610| 2e 0d 20 20 20 2a 20 49 | 66 20 79 6f 75 20 61 72 |..   * I|f you ar|
|00003620| 65 20 67 65 74 74 69 6e | 67 20 6f 72 20 73 65 74 |e gettin|g or set|
|00003630| 74 69 6e 67 20 6d 75 6c | 74 69 70 6c 65 20 70 72 |ting mul|tiple pr|
|00003640| 65 66 65 72 65 6e 63 65 | 73 2c 20 79 6f 75 20 73 |eference|s, you s|
|00003650| 68 6f 75 6c 64 20 70 6c | 61 63 65 0d 20 20 20 2a |hould pl|ace.   *|
|00003660| 20 74 68 65 73 65 20 63 | 61 6c 6c 73 20 77 69 74 | these c|alls wit|
|00003670| 68 69 6e 20 61 6e 20 49 | 43 42 65 67 69 6e 2f 49 |hin an I|CBegin/I|
|00003680| 43 45 6e 64 20 70 61 69 | 72 2e 0d 20 20 20 2a 20 |CEnd pai|r..   * |
|00003690| 49 66 20 79 6f 75 20 63 | 61 6c 6c 20 74 68 69 73 |If you c|all this|
|000036a0| 20 72 6f 75 74 69 6e 65 | 20 6f 75 74 73 69 64 65 | routine| outside|
|000036b0| 20 6f 66 20 73 75 63 68 | 20 61 20 70 61 69 72 2c | of such| a pair,|
|000036c0| 20 69 74 20 69 6d 70 6c | 69 63 69 74 6c 79 0d 20 | it impl|icitly. |
|000036d0| 20 20 2a 20 63 61 6c 6c | 73 20 49 43 42 65 67 69 |  * call|s ICBegi|
|000036e0| 6e 28 69 6e 73 74 2c 20 | 69 63 52 65 61 64 4f 6e |n(inst, |icReadOn|
|000036f0| 6c 79 50 65 72 6d 29 2e | 0d 20 20 20 2a 20 54 68 |lyPerm).|.   * Th|
|00003700| 69 73 20 72 6f 75 74 69 | 6e 65 20 69 73 20 6e 6f |is routi|ne is no|
|00003710| 77 20 6f 62 73 6f 6c 65 | 74 65 2e 20 55 73 65 20 |w obsole|te. Use |
|00003720| 49 43 46 69 6e 64 50 72 | 65 66 48 61 6e 64 6c 65 |ICFindPr|efHandle|
|00003730| 20 69 6e 73 74 65 61 64 | 2e 0d 20 20 20 2a 20 52 | instead|..   * R|
|00003740| 65 61 64 73 20 74 68 65 | 20 70 72 65 66 65 72 65 |eads the| prefere|
|00003750| 6e 63 65 20 73 70 65 63 | 69 66 69 65 64 20 62 79 |nce spec|ified by|
|00003760| 20 6b 65 79 20 66 72 6f | 6d 20 74 68 65 20 49 43 | key fro|m the IC|
|00003770| 20 64 61 74 61 62 61 73 | 65 20 69 6e 74 6f 0d 20 | databas|e into. |
|00003780| 20 20 2a 20 61 20 6e 65 | 77 6c 79 20 63 72 65 61 |  * a ne|wly crea|
|00003790| 74 65 64 20 68 61 6e 64 | 6c 65 2c 20 70 72 65 66 |ted hand|le, pref|
|000037a0| 68 2e 0d 20 20 20 2a 20 | 6b 65 79 20 6d 75 73 74 |h..   * |key must|
|000037b0| 20 6e 6f 74 20 62 65 20 | 74 68 65 20 65 6d 70 74 | not be |the empt|
|000037c0| 79 20 73 74 72 69 6e 67 | 2e 0d 20 20 20 2a 20 61 |y string|..   * a|
|000037d0| 74 74 72 20 69 73 20 73 | 65 74 20 74 6f 20 74 68 |ttr is s|et to th|
|000037e0| 65 20 61 74 74 72 69 62 | 75 74 65 73 20 61 73 73 |e attrib|utes ass|
|000037f0| 6f 63 69 61 74 65 64 20 | 77 69 74 68 20 74 68 65 |ociated |with the|
|00003800| 20 70 72 65 66 65 72 65 | 6e 63 65 2e 0d 20 20 20 | prefere|nce..   |
|00003810| 2a 20 54 68 65 20 69 6e | 63 6f 6d 69 6e 67 20 76 |* The in|coming v|
|00003820| 61 6c 75 65 20 6f 66 20 | 70 72 65 66 68 20 69 73 |alue of |prefh is|
|00003830| 20 69 67 6e 6f 72 65 64 | 2e 0d 20 20 20 2a 20 41 | ignored|..   * A|
|00003840| 20 6e 65 77 20 68 61 6e | 64 6c 65 20 69 73 20 63 | new han|dle is c|
|00003850| 72 65 61 74 65 64 20 69 | 6e 20 74 68 65 20 63 75 |reated i|n the cu|
|00003860| 72 72 65 6e 74 20 68 65 | 61 70 20 61 6e 64 20 72 |rrent he|ap and r|
|00003870| 65 74 75 72 6e 65 64 20 | 69 6e 20 70 72 65 66 68 |eturned |in prefh|
|00003880| 2e 0d 20 20 20 2a 20 49 | 66 20 74 68 65 20 72 6f |..   * I|f the ro|
|00003890| 75 74 69 6e 65 20 72 65 | 74 75 72 6e 73 20 61 6e |utine re|turns an|
|000038a0| 20 65 72 72 6f 72 2c 20 | 70 72 65 66 68 20 69 73 | error, |prefh is|
|000038b0| 20 73 65 74 20 74 6f 20 | 6e 69 6c 2e 0d 20 20 20 | set to |nil..   |
|000038c0| 2a 20 49 66 20 74 68 65 | 20 70 72 65 66 65 72 65 |* If the| prefere|
|000038d0| 6e 63 65 20 64 6f 65 73 | 20 6e 6f 74 20 65 78 69 |nce does| not exi|
|000038e0| 73 74 2c 20 6e 6f 20 65 | 72 72 6f 72 20 69 73 20 |st, no e|rror is |
|000038f0| 72 65 74 75 72 6e 65 64 | 20 61 6e 64 20 70 72 65 |returned| and pre|
|00003900| 66 68 20 69 73 20 73 65 | 74 0d 20 20 20 2a 20 74 |fh is se|t.   * t|
|00003910| 6f 20 61 6e 20 65 6d 70 | 74 79 20 68 61 6e 64 6c |o an emp|ty handl|
|00003920| 65 2e 0d 20 20 20 2a 2f | 0d 0d 70 61 73 63 61 6c |e..   */|..pascal|
|00003930| 20 49 43 45 72 72 6f 72 | 20 49 43 43 53 65 74 50 | ICError| ICCSetP|
|00003940| 72 65 66 48 61 6e 64 6c | 65 28 69 6e 74 65 72 6e |refHandl|e(intern|
|00003950| 65 74 43 6f 6e 66 69 67 | 75 72 61 74 69 6f 6e 43 |etConfig|urationC|
|00003960| 6f 6d 70 6f 6e 65 6e 74 | 20 69 6e 73 74 2c 20 43 |omponent| inst, C|
|00003970| 6f 6e 73 74 53 74 72 32 | 35 35 50 61 72 61 6d 20 |onstStr2|55Param |
|00003980| 6b 65 79 2c 20 49 43 41 | 74 74 72 20 61 74 74 72 |key, ICA|ttr attr|
|00003990| 2c 20 48 61 6e 64 6c 65 | 20 70 72 65 66 68 29 0d |, Handle| prefh).|
|000039a0| 46 49 56 45 57 4f 52 44 | 49 4e 4c 49 4e 45 28 30 |FIVEWORD|INLINE(0|
|000039b0| 78 32 46 33 43 2c 20 31 | 32 2c 20 32 37 2c 20 30 |x2F3C, 1|2, 27, 0|
|000039c0| 78 37 30 30 30 2c 20 30 | 78 41 38 32 41 29 3b 0d |x7000, 0|xA82A);.|
|000039d0| 20 20 2f 2a 20 52 65 71 | 75 69 72 65 73 20 49 43 |  /* Req|uires IC|
|000039e0| 20 31 2e 31 2e 0d 20 20 | 20 2a 20 59 6f 75 20 6d | 1.1..  | * You m|
|000039f0| 75 73 74 20 73 70 65 63 | 69 66 79 20 61 20 63 6f |ust spec|ify a co|
|00003a00| 6e 66 69 67 75 72 61 74 | 69 6f 6e 20 62 65 66 6f |nfigurat|ion befo|
|00003a10| 72 65 20 63 61 6c 6c 69 | 6e 67 20 74 68 69 73 20 |re calli|ng this |
|00003a20| 72 6f 75 74 69 6e 65 2e | 0d 20 20 20 2a 20 49 66 |routine.|.   * If|
|00003a30| 20 79 6f 75 20 61 72 65 | 20 67 65 74 74 69 6e 67 | you are| getting|
|00003a40| 20 6f 72 20 73 65 74 74 | 69 6e 67 20 6d 75 6c 74 | or sett|ing mult|
|00003a50| 69 70 6c 65 20 70 72 65 | 66 65 72 65 6e 63 65 73 |iple pre|ferences|
|00003a60| 2c 20 79 6f 75 20 73 68 | 6f 75 6c 64 20 70 6c 61 |, you sh|ould pla|
|00003a70| 63 65 0d 20 20 20 2a 20 | 74 68 65 73 65 20 63 61 |ce.   * |these ca|
|00003a80| 6c 6c 73 20 77 69 74 68 | 69 6e 20 61 6e 20 49 43 |lls with|in an IC|
|00003a90| 42 65 67 69 6e 2f 49 43 | 45 6e 64 20 70 61 69 72 |Begin/IC|End pair|
|00003aa0| 2e 0d 20 20 20 2a 20 49 | 66 20 79 6f 75 20 63 61 |..   * I|f you ca|
|00003ab0| 6c 6c 20 74 68 69 73 20 | 72 6f 75 74 69 6e 65 20 |ll this |routine |
|00003ac0| 6f 75 74 73 69 64 65 20 | 6f 66 20 73 75 63 68 20 |outside |of such |
|00003ad0| 61 20 70 61 69 72 2c 20 | 69 74 20 69 6d 70 6c 69 |a pair, |it impli|
|00003ae0| 63 69 74 6c 79 0d 20 20 | 20 2a 20 63 61 6c 6c 73 |citly.  | * calls|
|00003af0| 20 49 43 42 65 67 69 6e | 28 69 6e 73 74 2c 20 69 | ICBegin|(inst, i|
|00003b00| 63 52 65 61 64 57 72 69 | 74 65 50 65 72 6d 29 2e |cReadWri|tePerm).|
|00003b10| 0d 20 20 20 2a 20 53 65 | 74 73 20 74 68 65 20 70 |.   * Se|ts the p|
|00003b20| 72 65 66 65 72 65 6e 63 | 65 20 73 70 65 63 69 66 |referenc|e specif|
|00003b30| 69 65 64 20 62 79 20 6b | 65 79 20 66 72 6f 6d 20 |ied by k|ey from |
|00003b40| 74 68 65 20 49 43 20 64 | 61 74 61 62 61 73 65 20 |the IC d|atabase |
|00003b50| 74 6f 20 74 68 65 0d 20 | 20 20 2a 20 76 61 6c 75 |to the. |  * valu|
|00003b60| 65 20 63 6f 6e 74 61 69 | 6e 65 64 20 69 6e 20 70 |e contai|ned in p|
|00003b70| 72 65 66 68 2e 0d 20 20 | 20 2a 20 6b 65 79 20 6d |refh..  | * key m|
|00003b80| 75 73 74 20 6e 6f 74 20 | 62 65 20 74 68 65 20 65 |ust not |be the e|
|00003b90| 6d 70 74 79 20 73 74 72 | 69 6e 67 2e 0d 20 20 20 |mpty str|ing..   |
|00003ba0| 2a 20 49 66 20 70 72 65 | 66 68 20 69 73 20 6e 69 |* If pre|fh is ni|
|00003bb0| 6c 20 74 68 65 6e 20 74 | 68 65 20 70 72 65 66 65 |l then t|he prefe|
|00003bc0| 72 65 6e 63 65 20 76 61 | 6c 75 65 20 69 73 20 6e |rence va|lue is n|
|00003bd0| 6f 74 20 73 65 74 2e 0d | 20 20 20 2a 20 49 66 20 |ot set..|   * If |
|00003be0| 62 75 66 20 69 73 20 6e | 6f 74 20 6e 69 6c 20 74 |buf is n|ot nil t|
|00003bf0| 68 65 6e 20 74 68 65 20 | 70 72 65 66 65 72 65 6e |hen the |preferen|
|00003c00| 63 65 20 76 61 6c 75 65 | 20 69 73 20 73 65 74 20 |ce value| is set |
|00003c10| 74 6f 20 74 68 65 20 64 | 61 74 61 0d 20 20 20 2a |to the d|ata.   *|
|00003c20| 20 63 6f 6e 74 61 69 6e | 65 64 20 69 6e 20 69 74 | contain|ed in it|
|00003c30| 2e 0d 20 20 20 2a 20 49 | 66 20 61 74 74 72 20 69 |..   * I|f attr i|
|00003c40| 73 20 49 43 61 74 74 72 | 5f 6e 6f 5f 63 68 61 6e |s ICattr|_no_chan|
|00003c50| 67 65 20 74 68 65 6e 20 | 74 68 65 20 70 72 65 66 |ge then |the pref|
|00003c60| 65 72 65 6e 63 65 20 61 | 74 74 72 69 62 75 74 65 |erence a|ttribute|
|00003c70| 73 20 61 72 65 20 6e 6f | 74 20 73 65 74 2e 0d 20 |s are no|t set.. |
|00003c80| 20 20 2a 20 4f 74 68 65 | 72 77 69 73 65 20 74 68 |  * Othe|rwise th|
|00003c90| 65 20 70 72 65 66 65 72 | 65 6e 63 65 20 61 74 74 |e prefer|ence att|
|00003ca0| 72 69 62 75 74 65 73 20 | 61 72 65 20 73 65 74 20 |ributes |are set |
|00003cb0| 74 6f 20 61 74 74 72 2e | 0d 20 20 20 2a 20 52 65 |to attr.|.   * Re|
|00003cc0| 74 75 72 6e 73 20 69 63 | 50 65 72 6d 45 72 72 20 |turns ic|PermErr |
|00003cd0| 69 66 20 74 68 65 20 70 | 72 65 76 69 6f 75 73 20 |if the p|revious |
|00003ce0| 49 43 42 65 67 69 6e 20 | 77 61 73 20 70 61 73 73 |ICBegin |was pass|
|00003cf0| 65 64 20 69 63 52 65 61 | 64 4f 6e 6c 79 50 65 72 |ed icRea|dOnlyPer|
|00003d00| 6d 2e 0d 20 20 20 2a 20 | 52 65 74 75 72 6e 73 20 |m..   * |Returns |
|00003d10| 69 63 50 65 72 6d 45 72 | 72 20 69 66 20 63 75 72 |icPermEr|r if cur|
|00003d20| 72 65 6e 74 20 61 74 74 | 72 20 69 73 20 6c 6f 63 |rent att|r is loc|
|00003d30| 6b 65 64 2c 20 6e 65 77 | 20 61 74 74 72 20 69 73 |ked, new| attr is|
|00003d40| 20 6c 6f 63 6b 65 64 20 | 61 6e 64 20 70 72 65 66 | locked |and pref|
|00003d50| 68 20 3c 3e 20 6e 69 6c | 2e 0d 20 20 20 2a 2f 0d |h <> nil|..   */.|
|00003d60| 0d 70 61 73 63 61 6c 20 | 49 43 45 72 72 6f 72 20 |.pascal |ICError |
|00003d70| 49 43 43 43 6f 75 6e 74 | 50 72 65 66 28 69 6e 74 |ICCCount|Pref(int|
|00003d80| 65 72 6e 65 74 43 6f 6e | 66 69 67 75 72 61 74 69 |ernetCon|figurati|
|00003d90| 6f 6e 43 6f 6d 70 6f 6e | 65 6e 74 20 69 6e 73 74 |onCompon|ent inst|
|00003da0| 2c 20 6c 6f 6e 67 20 2a | 63 6f 75 6e 74 29 0d 46 |, long *|count).F|
|00003db0| 49 56 45 57 4f 52 44 49 | 4e 4c 49 4e 45 28 30 78 |IVEWORDI|NLINE(0x|
|00003dc0| 32 46 33 43 2c 20 34 2c | 20 38 2c 20 30 78 37 30 |2F3C, 4,| 8, 0x70|
|00003dd0| 30 30 2c 20 30 78 41 38 | 32 41 29 3b 0d 20 20 2f |00, 0xA8|2A);.  /|
|00003de0| 2a 20 59 6f 75 20 6d 75 | 73 74 20 73 70 65 63 69 |* You mu|st speci|
|00003df0| 66 79 20 61 20 63 6f 6e | 66 69 67 75 72 61 74 69 |fy a con|figurati|
|00003e00| 6f 6e 20 62 65 66 6f 72 | 65 20 63 61 6c 6c 69 6e |on befor|e callin|
|00003e10| 67 20 74 68 69 73 20 72 | 6f 75 74 69 6e 65 2e 0d |g this r|outine..|
|00003e20| 20 20 20 2a 20 59 6f 75 | 20 6d 75 73 74 20 62 65 |   * You| must be|
|00003e30| 20 69 6e 73 69 64 65 20 | 61 6e 20 49 43 42 65 67 | inside |an ICBeg|
|00003e40| 69 6e 2f 45 6e 64 20 70 | 61 69 72 20 74 6f 20 63 |in/End p|air to c|
|00003e50| 61 6c 6c 20 74 68 69 73 | 20 72 6f 75 74 69 6e 65 |all this| routine|
|00003e60| 2e 0d 20 20 20 2a 20 43 | 6f 75 6e 74 73 20 74 68 |..   * C|ounts th|
|00003e70| 65 20 74 6f 74 61 6c 20 | 6e 75 6d 62 65 72 20 6f |e total |number o|
|00003e80| 66 20 70 72 65 66 65 72 | 65 6e 63 65 73 2e 0d 20 |f prefer|ences.. |
|00003e90| 20 20 2a 20 49 66 20 74 | 68 65 20 72 6f 75 74 69 |  * If t|he routi|
|00003ea0| 6e 65 20 72 65 74 75 72 | 6e 73 20 61 6e 20 65 72 |ne retur|ns an er|
|00003eb0| 72 6f 72 2c 20 63 6f 75 | 6e 74 20 69 73 20 73 65 |ror, cou|nt is se|
|00003ec0| 74 20 74 6f 20 30 2e 0d | 20 20 20 2a 2f 0d 0d 70 |t to 0..|   */..p|
|00003ed0| 61 73 63 61 6c 20 49 43 | 45 72 72 6f 72 20 49 43 |ascal IC|Error IC|
|00003ee0| 43 47 65 74 49 6e 64 50 | 72 65 66 28 69 6e 74 65 |CGetIndP|ref(inte|
|00003ef0| 72 6e 65 74 43 6f 6e 66 | 69 67 75 72 61 74 69 6f |rnetConf|iguratio|
|00003f00| 6e 43 6f 6d 70 6f 6e 65 | 6e 74 20 69 6e 73 74 2c |nCompone|nt inst,|
|00003f10| 20 6c 6f 6e 67 20 6e 2c | 20 53 74 72 32 35 35 20 | long n,| Str255 |
|00003f20| 6b 65 79 29 0d 46 49 56 | 45 57 4f 52 44 49 4e 4c |key).FIV|EWORDINL|
|00003f30| 49 4e 45 28 30 78 32 46 | 33 43 2c 20 38 2c 20 39 |INE(0x2F|3C, 8, 9|
|00003f40| 2c 20 30 78 37 30 30 30 | 2c 20 30 78 41 38 32 41 |, 0x7000|, 0xA82A|
|00003f50| 29 3b 0d 20 20 2f 2a 20 | 59 6f 75 20 6d 75 73 74 |);.  /* |You must|
|00003f60| 20 73 70 65 63 69 66 79 | 20 61 20 63 6f 6e 66 69 | specify| a confi|
|00003f70| 67 75 72 61 74 69 6f 6e | 20 62 65 66 6f 72 65 20 |guration| before |
|00003f80| 63 61 6c 6c 69 6e 67 20 | 74 68 69 73 20 72 6f 75 |calling |this rou|
|00003f90| 74 69 6e 65 2e 0d 20 20 | 20 2a 20 59 6f 75 20 6d |tine..  | * You m|
|00003fa0| 75 73 74 20 62 65 20 69 | 6e 73 69 64 65 20 61 6e |ust be i|nside an|
|00003fb0| 20 49 43 42 65 67 69 6e | 2f 45 6e 64 20 70 61 69 | ICBegin|/End pai|
|00003fc0| 72 20 74 6f 20 63 61 6c | 6c 20 74 68 69 73 20 72 |r to cal|l this r|
|00003fd0| 6f 75 74 69 6e 65 2e 0d | 20 20 20 2a 20 52 65 74 |outine..|   * Ret|
|00003fe0| 75 72 6e 73 20 74 68 65 | 20 6b 65 79 20 6f 66 20 |urns the| key of |
|00003ff0| 74 68 65 20 4e 74 68 20 | 70 72 65 66 65 72 65 6e |the Nth |preferen|
|00004000| 63 65 2e 0d 20 20 20 2a | 20 6e 20 6d 75 73 74 20 |ce..   *| n must |
|00004010| 62 65 20 70 6f 73 69 74 | 69 76 65 2e 0d 20 20 20 |be posit|ive..   |
|00004020| 2a 20 52 65 74 75 72 6e | 73 20 69 63 50 72 65 66 |* Return|s icPref|
|00004030| 4e 6f 74 46 6f 75 6e 64 | 45 72 72 20 69 66 20 6e |NotFound|Err if n|
|00004040| 20 69 73 20 67 72 65 61 | 74 65 72 20 74 68 61 6e | is grea|ter than|
|00004050| 20 74 68 65 20 74 6f 74 | 61 6c 20 6e 75 6d 62 65 | the tot|al numbe|
|00004060| 72 20 6f 66 20 70 72 65 | 66 65 72 65 6e 63 65 73 |r of pre|ferences|
|00004070| 2e 0d 20 20 20 2a 20 49 | 66 20 74 68 65 20 72 6f |..   * I|f the ro|
|00004080| 75 74 69 6e 65 20 72 65 | 74 75 72 6e 73 20 61 6e |utine re|turns an|
|00004090| 20 65 72 72 6f 72 2c 20 | 6b 65 79 20 69 73 20 75 | error, |key is u|
|000040a0| 6e 64 65 66 69 6e 65 64 | 2e 0d 20 20 20 2a 2f 0d |ndefined|..   */.|
|000040b0| 0d 70 61 73 63 61 6c 20 | 49 43 45 72 72 6f 72 20 |.pascal |ICError |
|000040c0| 49 43 43 44 65 6c 65 74 | 65 50 72 65 66 28 69 6e |ICCDelet|ePref(in|
|000040d0| 74 65 72 6e 65 74 43 6f | 6e 66 69 67 75 72 61 74 |ternetCo|nfigurat|
|000040e0| 69 6f 6e 43 6f 6d 70 6f | 6e 65 6e 74 20 69 6e 73 |ionCompo|nent ins|
|000040f0| 74 2c 20 43 6f 6e 73 74 | 53 74 72 32 35 35 50 61 |t, Const|Str255Pa|
|00004100| 72 61 6d 20 6b 65 79 29 | 0d 46 49 56 45 57 4f 52 |ram key)|.FIVEWOR|
|00004110| 44 49 4e 4c 49 4e 45 28 | 30 78 32 46 33 43 2c 20 |DINLINE(|0x2F3C, |
|00004120| 34 2c 20 31 32 2c 20 30 | 78 37 30 30 30 2c 20 30 |4, 12, 0|x7000, 0|
|00004130| 78 41 38 32 41 29 3b 0d | 20 20 2f 2a 20 59 6f 75 |xA82A);.|  /* You|
|00004140| 20 6d 75 73 74 20 73 70 | 65 63 69 66 79 20 61 20 | must sp|ecify a |
|00004150| 63 6f 6e 66 69 67 75 72 | 61 74 69 6f 6e 20 62 65 |configur|ation be|
|00004160| 66 6f 72 65 20 63 61 6c | 6c 69 6e 67 20 74 68 69 |fore cal|ling thi|
|00004170| 73 20 72 6f 75 74 69 6e | 65 2e 0d 20 20 20 2a 20 |s routin|e..   * |
|00004180| 59 6f 75 20 6d 75 73 74 | 20 62 65 20 69 6e 73 69 |You must| be insi|
|00004190| 64 65 20 61 6e 20 49 43 | 42 65 67 69 6e 2f 45 6e |de an IC|Begin/En|
|000041a0| 64 20 70 61 69 72 20 74 | 6f 20 63 61 6c 6c 20 74 |d pair t|o call t|
|000041b0| 68 69 73 20 72 6f 75 74 | 69 6e 65 2e 0d 20 20 20 |his rout|ine..   |
|000041c0| 2a 20 44 65 6c 65 74 65 | 73 20 74 68 65 20 70 72 |* Delete|s the pr|
|000041d0| 65 66 65 72 65 6e 63 65 | 20 73 70 65 63 69 66 69 |eference| specifi|
|000041e0| 65 64 20 62 79 20 6b 65 | 79 2e 0d 20 20 20 2a 20 |ed by ke|y..   * |
|000041f0| 6b 65 79 20 6d 75 73 74 | 20 6e 6f 74 20 62 65 20 |key must| not be |
|00004200| 74 68 65 20 65 6d 70 74 | 79 20 73 74 72 69 6e 67 |the empt|y string|
|00004210| 2e 0d 20 20 20 2a 20 52 | 65 74 75 72 6e 73 20 69 |..   * R|eturns i|
|00004220| 63 50 72 65 66 4e 6f 74 | 46 6f 75 6e 64 20 69 66 |cPrefNot|Found if|
|00004230| 20 74 68 65 20 70 72 65 | 66 65 72 65 6e 63 65 20 | the pre|ference |
|00004240| 73 70 65 63 69 66 69 65 | 64 20 62 79 20 6b 65 79 |specifie|d by key|
|00004250| 20 69 73 20 6e 6f 74 20 | 70 72 65 73 65 6e 74 2e | is not |present.|
|00004260| 0d 20 20 20 2a 2f 0d 0d | 70 61 73 63 61 6c 20 49 |.   */..|pascal I|
|00004270| 43 45 72 72 6f 72 20 49 | 43 43 45 6e 64 28 69 6e |CError I|CCEnd(in|
|00004280| 74 65 72 6e 65 74 43 6f | 6e 66 69 67 75 72 61 74 |ternetCo|nfigurat|
|00004290| 69 6f 6e 43 6f 6d 70 6f | 6e 65 6e 74 20 69 6e 73 |ionCompo|nent ins|
|000042a0| 74 29 0d 46 49 56 45 57 | 4f 52 44 49 4e 4c 49 4e |t).FIVEW|ORDINLIN|
|000042b0| 45 28 30 78 32 46 33 43 | 2c 20 30 2c 20 31 30 2c |E(0x2F3C|, 0, 10,|
|000042c0| 20 30 78 37 30 30 30 2c | 20 30 78 41 38 32 41 29 | 0x7000,| 0xA82A)|
|000042d0| 3b 0d 20 20 2f 2a 20 59 | 6f 75 20 6d 75 73 74 20 |;.  /* Y|ou must |
|000042e0| 73 70 65 63 69 66 79 20 | 61 20 63 6f 6e 66 69 67 |specify |a config|
|000042f0| 75 72 61 74 69 6f 6e 20 | 62 65 66 6f 72 65 20 63 |uration |before c|
|00004300| 61 6c 6c 69 6e 67 20 74 | 68 69 73 20 72 6f 75 74 |alling t|his rout|
|00004310| 69 6e 65 2e 0d 20 20 20 | 2a 20 59 6f 75 20 6d 75 |ine..   |* You mu|
|00004320| 73 74 20 62 65 20 69 6e | 73 69 64 65 20 61 6e 20 |st be in|side an |
|00004330| 49 43 42 65 67 69 6e 2f | 45 6e 64 20 70 61 69 72 |ICBegin/|End pair|
|00004340| 20 74 6f 20 63 61 6c 6c | 20 74 68 69 73 20 72 6f | to call| this ro|
|00004350| 75 74 69 6e 65 2e 0d 20 | 20 20 2a 20 54 65 72 6d |utine.. |  * Term|
|00004360| 69 6e 61 74 65 73 20 61 | 20 70 72 65 66 65 72 65 |inates a| prefere|
|00004370| 6e 63 65 20 73 65 73 73 | 69 6f 6e 2c 20 61 73 20 |nce sess|ion, as |
|00004380| 73 74 61 72 74 65 64 20 | 62 79 20 49 43 42 65 67 |started |by ICBeg|
|00004390| 69 6e 2e 0d 20 20 20 2a | 20 59 6f 75 20 6d 75 73 |in..   *| You mus|
|000043a0| 74 20 68 61 76 65 20 63 | 61 6c 6c 65 64 20 49 43 |t have c|alled IC|
|000043b0| 42 65 67 69 6e 20 62 65 | 66 6f 72 65 20 63 61 6c |Begin be|fore cal|
|000043c0| 6c 69 6e 67 20 74 68 69 | 73 20 72 6f 75 74 69 6e |ling thi|s routin|
|000043d0| 65 2e 0d 20 20 20 2a 2f | 0d 0d 2f 2a 20 2a 2a 2a |e..   */|../* ***|
|000043e0| 2a 2a 20 55 73 65 72 20 | 49 6e 74 65 72 66 61 63 |** User |Interfac|
|000043f0| 65 20 53 74 75 66 66 20 | 2a 2a 2a 2a 2a 20 2a 2f |e Stuff |***** */|
|00004400| 0d 0d 70 61 73 63 61 6c | 20 49 43 45 72 72 6f 72 |..pascal| ICError|
|00004410| 20 49 43 43 45 64 69 74 | 50 72 65 66 65 72 65 6e | ICCEdit|Preferen|
|00004420| 63 65 73 28 69 6e 74 65 | 72 6e 65 74 43 6f 6e 66 |ces(inte|rnetConf|
|00004430| 69 67 75 72 61 74 69 6f | 6e 43 6f 6d 70 6f 6e 65 |iguratio|nCompone|
|00004440| 6e 74 20 69 6e 73 74 2c | 20 43 6f 6e 73 74 53 74 |nt inst,| ConstSt|
|00004450| 72 32 35 35 50 61 72 61 | 6d 20 6b 65 79 29 0d 46 |r255Para|m key).F|
|00004460| 49 56 45 57 4f 52 44 49 | 4e 4c 49 4e 45 28 30 78 |IVEWORDI|NLINE(0x|
|00004470| 32 46 33 43 2c 20 34 2c | 20 31 35 2c 20 30 78 37 |2F3C, 4,| 15, 0x7|
|00004480| 30 30 30 2c 20 30 78 41 | 38 32 41 29 3b 0d 20 20 |000, 0xA|82A);.  |
|00004490| 2f 2a 20 52 65 71 75 69 | 72 65 73 20 49 43 20 31 |/* Requi|res IC 1|
|000044a0| 2e 31 2e 0d 20 20 20 2a | 20 59 6f 75 20 6d 75 73 |.1..   *| You mus|
|000044b0| 74 20 73 70 65 63 69 66 | 79 20 61 20 63 6f 6e 66 |t specif|y a conf|
|000044c0| 69 67 75 72 61 74 69 6f | 6e 20 62 65 66 6f 72 65 |iguratio|n before|
|000044d0| 20 63 61 6c 6c 69 6e 67 | 20 74 68 69 73 20 72 6f | calling| this ro|
|000044e0| 75 74 69 6e 65 2e 0d 20 | 20 20 2a 20 59 6f 75 20 |utine.. |  * You |
|000044f0| 64 6f 20 6e 6f 74 20 68 | 61 76 65 20 74 6f 20 62 |do not h|ave to b|
|00004500| 65 20 69 6e 73 69 64 65 | 20 61 6e 20 49 43 42 65 |e inside| an ICBe|
|00004510| 67 69 6e 2f 45 6e 64 20 | 70 61 69 72 20 74 6f 20 |gin/End |pair to |
|00004520| 63 61 6c 6c 20 74 68 69 | 73 20 72 6f 75 74 69 6e |call thi|s routin|
|00004530| 65 2e 0d 20 20 20 2a 20 | 49 6e 73 74 72 75 63 74 |e..   * |Instruct|
|00004540| 73 20 49 43 20 74 6f 20 | 64 69 73 70 6c 61 79 20 |s IC to |display |
|00004550| 74 68 65 20 75 73 65 72 | 20 69 6e 74 65 72 66 61 |the user| interfa|
|00004560| 63 65 20 61 73 73 6f 63 | 69 61 74 65 64 20 77 69 |ce assoc|iated wi|
|00004570| 74 68 20 65 64 69 74 69 | 6e 67 0d 20 20 20 2a 20 |th editi|ng.   * |
|00004580| 70 72 65 66 65 72 65 6e | 63 65 73 20 61 6e 64 20 |preferen|ces and |
|00004590| 66 6f 63 75 73 69 6e 67 | 20 6f 6e 20 74 68 65 20 |focusing| on the |
|000045a0| 70 72 65 66 65 72 65 6e | 63 65 20 73 70 65 63 69 |preferen|ce speci|
|000045b0| 66 69 65 64 20 62 79 20 | 6b 65 79 2e 0d 20 20 20 |fied by |key..   |
|000045c0| 2a 20 49 66 20 6b 65 79 | 20 69 73 20 74 68 65 20 |* If key| is the |
|000045d0| 65 6d 70 74 79 20 73 74 | 72 69 6e 67 20 74 68 65 |empty st|ring the|
|000045e0| 6e 20 6e 6f 20 70 72 65 | 66 65 72 65 6e 63 65 20 |n no pre|ference |
|000045f0| 73 68 6f 75 6c 64 20 62 | 65 20 66 6f 63 75 73 65 |should b|e focuse|
|00004600| 64 20 75 70 6f 6e 2e 0d | 20 20 20 2a 20 59 6f 75 |d upon..|   * You|
|00004610| 20 6d 75 73 74 20 68 61 | 76 65 20 73 70 65 63 69 | must ha|ve speci|
|00004620| 66 69 65 64 20 61 20 63 | 6f 6e 66 69 67 75 72 61 |fied a c|onfigura|
|00004630| 74 69 6f 6e 20 62 65 66 | 6f 72 65 20 63 61 6c 6c |tion bef|ore call|
|00004640| 69 6e 67 20 74 68 69 73 | 20 72 6f 75 74 69 6e 65 |ing this| routine|
|00004650| 2e 0d 20 20 20 2a 20 59 | 6f 75 20 64 6f 20 6e 6f |..   * Y|ou do no|
|00004660| 74 20 6e 65 65 64 20 74 | 6f 20 63 61 6c 6c 20 49 |t need t|o call I|
|00004670| 43 42 65 67 69 6e 20 62 | 65 66 6f 72 65 20 63 61 |CBegin b|efore ca|
|00004680| 6c 6c 69 6e 67 20 74 68 | 69 73 20 72 6f 75 74 69 |lling th|is routi|
|00004690| 6e 65 2e 0d 20 20 20 2a | 20 49 6e 20 74 68 65 20 |ne..   *| In the |
|000046a0| 63 75 72 72 65 6e 74 20 | 69 6d 70 6c 65 6d 65 6e |current |implemen|
|000046b0| 74 61 74 69 6f 6e 20 74 | 68 69 73 20 6c 61 75 6e |tation t|his laun|
|000046c0| 63 68 65 73 20 74 68 65 | 20 49 43 20 61 70 70 6c |ches the| IC appl|
|000046d0| 69 63 61 74 69 6f 6e 0d | 20 20 20 2a 20 28 6f 72 |ication.|   * (or|
|000046e0| 20 62 72 69 6e 67 73 20 | 69 74 20 74 6f 20 74 68 | brings |it to th|
|000046f0| 65 20 66 72 6f 6e 74 29 | 20 61 6e 64 20 64 69 73 |e front)| and dis|
|00004700| 70 6c 61 79 73 20 74 68 | 65 20 77 69 6e 64 6f 77 |plays th|e window|
|00004710| 20 63 6f 6e 74 61 69 6e | 69 6e 67 0d 20 20 20 2a | contain|ing.   *|
|00004720| 20 74 68 65 20 70 72 65 | 66 65 72 65 6e 63 65 20 | the pre|ference |
|00004730| 73 70 65 63 69 66 69 65 | 64 20 62 79 20 6b 65 79 |specifie|d by key|
|00004740| 2e 0d 20 20 20 2a 20 49 | 74 20 6d 61 79 20 68 61 |..   * I|t may ha|
|00004750| 76 65 20 61 20 72 61 64 | 69 63 61 6c 6c 79 20 64 |ve a rad|ically d|
|00004760| 69 66 66 65 72 65 6e 74 | 20 69 6d 70 6c 65 6d 65 |ifferent| impleme|
|00004770| 6e 74 61 74 69 6f 6e 20 | 69 6e 20 66 75 74 75 72 |ntation |in futur|
|00004780| 65 0d 20 20 20 2a 20 49 | 43 20 73 79 73 74 65 6d |e.   * I|C system|
|00004790| 73 2e 0d 20 20 20 2a 2f | 0d 0d 2f 2a 20 2a 2a 2a |s..   */|../* ***|
|000047a0| 2a 2a 20 55 52 4c 20 48 | 61 6e 64 6c 69 6e 67 20 |** URL H|andling |
|000047b0| 2a 2a 2a 2a 2a 20 2a 2f | 0d 0d 70 61 73 63 61 6c |***** */|..pascal|
|000047c0| 20 49 43 45 72 72 6f 72 | 20 49 43 43 50 61 72 73 | ICError| ICCPars|
|000047d0| 65 55 52 4c 28 69 6e 74 | 65 72 6e 65 74 43 6f 6e |eURL(int|ernetCon|
|000047e0| 66 69 67 75 72 61 74 69 | 6f 6e 43 6f 6d 70 6f 6e |figurati|onCompon|
|000047f0| 65 6e 74 20 69 6e 73 74 | 2c 20 43 6f 6e 73 74 53 |ent inst|, ConstS|
|00004800| 74 72 32 35 35 50 61 72 | 61 6d 20 68 69 6e 74 2c |tr255Par|am hint,|
|00004810| 20 50 74 72 20 64 61 74 | 61 2c 20 6c 6f 6e 67 20 | Ptr dat|a, long |
|00004820| 6c 65 6e 2c 20 6c 6f 6e | 67 20 2a 73 65 6c 53 74 |len, lon|g *selSt|
|00004830| 61 72 74 2c 20 6c 6f 6e | 67 20 2a 73 65 6c 45 6e |art, lon|g *selEn|
|00004840| 64 2c 20 48 61 6e 64 6c | 65 20 75 72 6c 29 0d 46 |d, Handl|e url).F|
|00004850| 49 56 45 57 4f 52 44 49 | 4e 4c 49 4e 45 28 30 78 |IVEWORDI|NLINE(0x|
|00004860| 32 46 33 43 2c 20 32 34 | 2c 20 31 36 2c 20 30 78 |2F3C, 24|, 16, 0x|
|00004870| 37 30 30 30 2c 20 30 78 | 41 38 32 41 29 3b 0d 20 |7000, 0x|A82A);. |
|00004880| 20 2f 2a 20 52 65 71 75 | 69 72 65 73 20 49 43 20 | /* Requ|ires IC |
|00004890| 31 2e 31 2e 0d 20 20 20 | 2a 20 59 6f 75 20 6d 75 |1.1..   |* You mu|
|000048a0| 73 74 20 73 70 65 63 69 | 66 79 20 61 20 63 6f 6e |st speci|fy a con|
|000048b0| 66 69 67 75 72 61 74 69 | 6f 6e 20 62 65 66 6f 72 |figurati|on befor|
|000048c0| 65 20 63 61 6c 6c 69 6e | 67 20 74 68 69 73 20 72 |e callin|g this r|
|000048d0| 6f 75 74 69 6e 65 2e 0d | 20 20 20 2a 20 59 6f 75 |outine..|   * You|
|000048e0| 20 64 6f 20 6e 6f 74 20 | 68 61 76 65 20 74 6f 20 | do not |have to |
|000048f0| 62 65 20 69 6e 73 69 64 | 65 20 61 6e 20 49 43 42 |be insid|e an ICB|
|00004900| 65 67 69 6e 2f 45 6e 64 | 20 70 61 69 72 20 74 6f |egin/End| pair to|
|00004910| 20 63 61 6c 6c 20 74 68 | 69 73 20 72 6f 75 74 69 | call th|is routi|
|00004920| 6e 65 2e 0d 20 20 20 2a | 20 50 61 72 73 65 73 20 |ne..   *| Parses |
|00004930| 61 20 55 52 4c 20 6f 75 | 74 20 6f 66 20 74 68 65 |a URL ou|t of the|
|00004940| 20 73 70 65 63 69 66 69 | 65 64 20 74 65 78 74 20 | specifi|ed text |
|00004950| 61 6e 64 20 72 65 74 75 | 72 6e 73 20 69 74 20 69 |and retu|rns it i|
|00004960| 6e 20 61 20 63 61 6e 6f | 6e 69 63 61 6c 20 66 6f |n a cano|nical fo|
|00004970| 72 6d 0d 20 20 20 2a 20 | 69 6e 20 61 20 68 61 6e |rm.   * |in a han|
|00004980| 64 6c 65 2e 0d 20 20 20 | 2a 20 68 69 6e 74 20 69 |dle..   |* hint i|
|00004990| 6e 64 69 63 61 74 65 73 | 20 74 68 65 20 64 65 66 |ndicates| the def|
|000049a0| 61 75 6c 74 20 73 63 68 | 65 6d 65 20 66 6f 72 20 |ault sch|eme for |
|000049b0| 55 52 4c 73 20 6f 66 20 | 74 68 65 20 66 6f 72 6d |URLs of |the form|
|000049c0| 20 22 6e 61 6d 65 40 61 | 64 64 72 65 73 73 22 2e | "name@a|ddress".|
|000049d0| 0d 20 20 20 2a 20 49 66 | 20 68 69 6e 74 20 69 73 |.   * If| hint is|
|000049e0| 20 74 68 65 20 65 6d 70 | 74 79 20 73 74 72 69 6e | the emp|ty strin|
|000049f0| 67 20 74 68 65 6e 20 55 | 52 4c 73 20 6f 66 20 74 |g then U|RLs of t|
|00004a00| 68 61 74 20 66 6f 72 6d | 20 61 72 65 20 6e 6f 74 |hat form| are not|
|00004a10| 20 61 6c 6c 6f 77 65 64 | 2e 0d 20 20 20 2a 20 64 | allowed|..   * d|
|00004a20| 61 74 61 20 70 6f 69 6e | 74 73 20 74 6f 20 74 68 |ata poin|ts to th|
|00004a30| 65 20 73 74 61 72 74 20 | 6f 66 20 74 68 65 20 74 |e start |of the t|
|00004a40| 65 78 74 2e 20 49 74 20 | 6d 75 73 74 20 6e 6f 74 |ext. It |must not|
|00004a50| 20 62 65 20 6e 69 6c 2e | 0d 20 20 20 2a 20 6c 65 | be nil.|.   * le|
|00004a60| 6e 20 69 6e 64 69 63 61 | 74 65 73 20 74 68 65 20 |n indica|tes the |
|00004a70| 6c 65 6e 67 74 68 20 6f | 66 20 74 68 65 20 74 65 |length o|f the te|
|00004a80| 78 74 2e 20 49 74 20 6d | 75 73 74 20 62 65 20 6e |xt. It m|ust be n|
|00004a90| 6f 6e 2d 6e 65 67 61 74 | 69 76 65 2e 0d 20 20 20 |on-negat|ive..   |
|00004aa0| 2a 20 73 65 6c 53 74 61 | 72 74 20 61 6e 64 20 73 |* selSta|rt and s|
|00004ab0| 65 6c 45 6e 64 20 73 68 | 6f 75 6c 64 20 62 65 20 |elEnd sh|ould be |
|00004ac0| 70 61 73 73 65 64 20 69 | 6e 20 61 73 20 74 68 65 |passed i|n as the|
|00004ad0| 20 63 75 72 72 65 6e 74 | 20 73 65 6c 65 63 74 69 | current| selecti|
|00004ae0| 6f 6e 20 6f 66 0d 20 20 | 20 2a 20 74 68 65 20 74 |on of.  | * the t|
|00004af0| 65 78 74 2e 20 54 68 69 | 73 20 73 65 6c 65 63 74 |ext. Thi|s select|
|00004b00| 69 6f 6e 20 69 73 20 67 | 69 76 65 6e 20 69 6e 20 |ion is g|iven in |
|00004b10| 74 68 65 20 73 61 6d 65 | 20 6d 61 6e 6e 65 72 20 |the same| manner |
|00004b20| 61 73 20 54 65 78 74 45 | 64 69 74 2c 0d 20 20 20 |as TextE|dit,.   |
|00004b30| 2a 20 69 65 20 69 66 20 | 73 65 6c 53 74 61 72 74 |* ie if |selStart|
|00004b40| 20 3d 20 73 65 6c 45 6e | 64 20 74 68 65 6e 20 74 | = selEn|d then t|
|00004b50| 68 65 72 65 20 69 73 20 | 6e 6f 20 73 65 6c 65 63 |here is |no selec|
|00004b60| 74 69 6f 6e 20 6f 6e 6c | 79 20 61 6e 20 69 6e 73 |tion onl|y an ins|
|00004b70| 65 72 74 69 6f 6e 0d 20 | 20 20 2a 20 70 6f 69 6e |ertion. |  * poin|
|00004b80| 74 2e 20 41 6c 73 6f 20 | 73 65 6c 53 74 61 72 74 |t. Also |selStart|
|00004b90| 20 b2 20 73 65 6c 45 6e | 64 20 61 6e 64 20 30 20 | . selEn|d and 0 |
|00004ba0| b2 20 73 65 6c 53 74 61 | 72 74 20 b2 20 6c 65 6e |. selSta|rt . len|
|00004bb0| 20 61 6e 64 20 30 20 b2 | 20 73 65 6c 45 6e 64 20 | and 0 .| selEnd |
|00004bc0| b2 20 6c 65 6e 2e 0d 20 | 20 20 2a 20 73 65 6c 53 |. len.. |  * selS|
|00004bd0| 74 61 72 74 20 61 6e 64 | 20 73 65 6c 45 6e 64 20 |tart and| selEnd |
|00004be0| 61 72 65 20 72 65 74 75 | 72 6e 65 64 20 61 73 20 |are retu|rned as |
|00004bf0| 74 68 65 20 62 6f 75 6e | 64 73 20 6f 66 20 74 68 |the boun|ds of th|
|00004c00| 65 20 55 52 4c 2e 20 49 | 66 20 74 68 65 0d 20 20 |e URL. I|f the.  |
|00004c10| 20 2a 20 72 6f 75 74 69 | 6e 65 20 72 65 74 75 72 | * routi|ne retur|
|00004c20| 6e 73 20 61 6e 20 65 72 | 72 6f 72 20 74 68 65 6e |ns an er|ror then|
|00004c30| 20 74 68 65 73 65 20 6e | 65 77 20 62 6f 75 6e 64 | these n|ew bound|
|00004c40| 61 72 69 65 73 20 6d 61 | 79 20 62 65 0d 20 20 20 |aries ma|y be.   |
|00004c50| 2a 20 69 6e 76 61 6c 69 | 64 20 62 75 74 20 74 68 |* invali|d but th|
|00004c60| 65 79 20 77 69 6c 6c 20 | 62 65 20 63 6c 6f 73 65 |ey will |be close|
|00004c70| 2e 0d 20 20 20 2a 20 54 | 68 65 20 69 6e 63 6f 6d |..   * T|he incom|
|00004c80| 69 6e 67 20 75 72 6c 20 | 68 61 6e 64 6c 65 20 6d |ing url |handle m|
|00004c90| 75 73 74 20 6e 6f 74 20 | 62 65 20 6e 69 6c 2e 20 |ust not |be nil. |
|00004ca0| 20 54 68 65 20 72 65 73 | 75 6c 74 69 6e 67 20 55 | The res|ulting U|
|00004cb0| 52 4c 20 69 73 20 6e 6f | 72 6d 61 6c 69 73 65 64 |RL is no|rmalised|
|00004cc0| 0d 20 20 20 2a 20 61 6e | 64 20 63 6f 70 69 65 64 |.   * an|d copied|
|00004cd0| 20 69 6e 74 6f 20 74 68 | 65 20 75 72 6c 20 68 61 | into th|e url ha|
|00004ce0| 6e 64 6c 65 2c 20 77 68 | 69 63 68 20 69 73 20 72 |ndle, wh|ich is r|
|00004cf0| 65 73 69 7a 65 64 20 74 | 6f 20 66 69 74 2e 0d 20 |esized t|o fit.. |
|00004d00| 20 20 2a 2f 0d 0d 70 61 | 73 63 61 6c 20 49 43 45 |  */..pa|scal ICE|
|00004d10| 72 72 6f 72 20 49 43 43 | 4c 61 75 6e 63 68 55 52 |rror ICC|LaunchUR|
|00004d20| 4c 28 69 6e 74 65 72 6e | 65 74 43 6f 6e 66 69 67 |L(intern|etConfig|
|00004d30| 75 72 61 74 69 6f 6e 43 | 6f 6d 70 6f 6e 65 6e 74 |urationC|omponent|
|00004d40| 20 69 6e 73 74 2c 20 43 | 6f 6e 73 74 53 74 72 32 | inst, C|onstStr2|
|00004d50| 35 35 50 61 72 61 6d 20 | 68 69 6e 74 2c 20 50 74 |55Param |hint, Pt|
|00004d60| 72 20 64 61 74 61 2c 20 | 6c 6f 6e 67 20 6c 65 6e |r data, |long len|
|00004d70| 2c 20 6c 6f 6e 67 20 2a | 73 65 6c 53 74 61 72 74 |, long *|selStart|
|00004d80| 2c 20 6c 6f 6e 67 20 2a | 73 65 6c 45 6e 64 29 0d |, long *|selEnd).|
|00004d90| 46 49 56 45 57 4f 52 44 | 49 4e 4c 49 4e 45 28 30 |FIVEWORD|INLINE(0|
|00004da0| 78 32 46 33 43 2c 20 32 | 30 2c 20 31 37 2c 20 30 |x2F3C, 2|0, 17, 0|
|00004db0| 78 37 30 30 30 2c 20 30 | 78 41 38 32 41 29 3b 0d |x7000, 0|xA82A);.|
|00004dc0| 20 20 2f 2a 20 52 65 71 | 75 69 72 65 73 20 49 43 |  /* Req|uires IC|
|00004dd0| 20 31 2e 31 2e 0d 20 20 | 20 2a 20 59 6f 75 20 6d | 1.1..  | * You m|
|00004de0| 75 73 74 20 73 70 65 63 | 69 66 79 20 61 20 63 6f |ust spec|ify a co|
|00004df0| 6e 66 69 67 75 72 61 74 | 69 6f 6e 20 62 65 66 6f |nfigurat|ion befo|
|00004e00| 72 65 20 63 61 6c 6c 69 | 6e 67 20 74 68 69 73 20 |re calli|ng this |
|00004e10| 72 6f 75 74 69 6e 65 2e | 0d 20 20 20 2a 20 59 6f |routine.|.   * Yo|
|00004e20| 75 20 64 6f 20 6e 6f 74 | 20 68 61 76 65 20 74 6f |u do not| have to|
|00004e30| 20 62 65 20 69 6e 73 69 | 64 65 20 61 6e 20 49 43 | be insi|de an IC|
|00004e40| 42 65 67 69 6e 2f 45 6e | 64 20 70 61 69 72 20 74 |Begin/En|d pair t|
|00004e50| 6f 20 63 61 6c 6c 20 74 | 68 69 73 20 72 6f 75 74 |o call t|his rout|
|00004e60| 69 6e 65 2e 0d 20 20 20 | 2a 20 50 61 72 73 65 73 |ine..   |* Parses|
|00004e70| 20 61 20 55 52 4c 20 6f | 75 74 20 6f 66 20 74 68 | a URL o|ut of th|
|00004e80| 65 20 73 70 65 63 69 66 | 69 65 64 20 74 65 78 74 |e specif|ied text|
|00004e90| 20 61 6e 64 20 66 65 65 | 64 73 20 69 74 20 6f 66 | and fee|ds it of|
|00004ea0| 66 20 74 6f 20 74 68 65 | 0d 20 20 20 2a 20 61 70 |f to the|.   * ap|
|00004eb0| 70 72 6f 70 72 69 61 74 | 65 20 68 65 6c 70 65 72 |propriat|e helper|
|00004ec0| 2e 0d 20 20 20 2a 20 68 | 69 6e 74 20 69 6e 64 69 |..   * h|int indi|
|00004ed0| 63 61 74 65 73 20 74 68 | 65 20 64 65 66 61 75 6c |cates th|e defaul|
|00004ee0| 74 20 73 63 68 65 6d 65 | 20 66 6f 72 20 55 52 4c |t scheme| for URL|
|00004ef0| 73 20 6f 66 20 74 68 65 | 20 66 6f 72 6d 20 22 6e |s of the| form "n|
|00004f00| 61 6d 65 40 61 64 64 72 | 65 73 73 22 2e 0d 20 20 |ame@addr|ess"..  |
|00004f10| 20 2a 20 49 66 20 68 69 | 6e 74 20 69 73 20 74 68 | * If hi|nt is th|
|00004f20| 65 20 65 6d 70 74 79 20 | 73 74 72 69 6e 67 20 74 |e empty |string t|
|00004f30| 68 65 6e 20 55 52 4c 73 | 20 6f 66 20 74 68 61 74 |hen URLs| of that|
|00004f40| 20 66 6f 72 6d 20 61 72 | 65 20 6e 6f 74 20 61 6c | form ar|e not al|
|00004f50| 6c 6f 77 65 64 2e 0d 20 | 20 20 2a 20 64 61 74 61 |lowed.. |  * data|
|00004f60| 20 70 6f 69 6e 74 73 20 | 74 6f 20 74 68 65 20 73 | points |to the s|
|00004f70| 74 61 72 74 20 6f 66 20 | 74 68 65 20 74 65 78 74 |tart of |the text|
|00004f80| 2e 20 49 74 20 6d 75 73 | 74 20 6e 6f 74 20 62 65 |. It mus|t not be|
|00004f90| 20 6e 69 6c 2e 0d 20 20 | 20 2a 20 6c 65 6e 20 69 | nil..  | * len i|
|00004fa0| 6e 64 69 63 61 74 65 73 | 20 74 68 65 20 6c 65 6e |ndicates| the len|
|00004fb0| 67 74 68 20 6f 66 20 74 | 68 65 20 74 65 78 74 2e |gth of t|he text.|
|00004fc0| 20 49 74 20 6d 75 73 74 | 20 62 65 20 6e 6f 6e 2d | It must| be non-|
|00004fd0| 6e 65 67 61 74 69 76 65 | 2e 0d 20 20 20 2a 20 73 |negative|..   * s|
|00004fe0| 65 6c 53 74 61 72 74 20 | 61 6e 64 20 73 65 6c 45 |elStart |and selE|
|00004ff0| 6e 64 20 73 68 6f 75 6c | 64 20 62 65 20 70 61 73 |nd shoul|d be pas|
|00005000| 73 65 64 20 69 6e 20 61 | 73 20 74 68 65 20 63 75 |sed in a|s the cu|
|00005010| 72 72 65 6e 74 20 73 65 | 6c 65 63 74 69 6f 6e 20 |rrent se|lection |
|00005020| 6f 66 0d 20 20 20 2a 20 | 74 68 65 20 74 65 78 74 |of.   * |the text|
|00005030| 2e 20 54 68 69 73 20 73 | 65 6c 65 63 74 69 6f 6e |. This s|election|
|00005040| 20 69 73 20 67 69 76 65 | 6e 20 69 6e 20 74 68 65 | is give|n in the|
|00005050| 20 73 61 6d 65 20 6d 61 | 6e 6e 65 72 20 61 73 20 | same ma|nner as |
|00005060| 54 65 78 74 45 64 69 74 | 2c 0d 20 20 20 2a 20 69 |TextEdit|,.   * i|
|00005070| 65 20 69 66 20 73 65 6c | 53 74 61 72 74 20 3d 20 |e if sel|Start = |
|00005080| 73 65 6c 45 6e 64 20 74 | 68 65 6e 20 74 68 65 72 |selEnd t|hen ther|
|00005090| 65 20 69 73 20 6e 6f 20 | 73 65 6c 65 63 74 69 6f |e is no |selectio|
|000050a0| 6e 20 6f 6e 6c 79 20 61 | 6e 20 69 6e 73 65 72 74 |n only a|n insert|
|000050b0| 69 6f 6e 0d 20 20 20 2a | 20 70 6f 69 6e 74 2e 20 |ion.   *| point. |
|000050c0| 41 6c 73 6f 20 73 65 6c | 53 74 61 72 74 20 b2 20 |Also sel|Start . |
|000050d0| 73 65 6c 45 6e 64 20 61 | 6e 64 20 30 20 b2 20 73 |selEnd a|nd 0 . s|
|000050e0| 65 6c 53 74 61 72 74 20 | b2 20 6c 65 6e 20 61 6e |elStart |. len an|
|000050f0| 64 20 30 20 b2 20 73 65 | 6c 45 6e 64 20 b2 20 6c |d 0 . se|lEnd . l|
|00005100| 65 6e 2e 0d 20 20 20 2a | 20 73 65 6c 53 74 61 72 |en..   *| selStar|
|00005110| 74 20 61 6e 64 20 73 65 | 6c 45 6e 64 20 61 72 65 |t and se|lEnd are|
|00005120| 20 72 65 74 75 72 6e 65 | 64 20 61 73 20 74 68 65 | returne|d as the|
|00005130| 20 62 6f 75 6e 64 73 20 | 6f 66 20 74 68 65 20 55 | bounds |of the U|
|00005140| 52 4c 2e 20 49 66 20 74 | 68 65 0d 20 20 20 2a 20 |RL. If t|he.   * |
|00005150| 72 6f 75 74 69 6e 65 20 | 72 65 74 75 72 6e 73 20 |routine |returns |
|00005160| 61 6e 20 65 72 72 6f 72 | 20 74 68 65 6e 20 74 68 |an error| then th|
|00005170| 65 73 65 20 6e 65 77 20 | 62 6f 75 6e 64 61 72 69 |ese new |boundari|
|00005180| 65 73 20 6d 61 79 20 62 | 65 0d 20 20 20 2a 20 69 |es may b|e.   * i|
|00005190| 6e 76 61 6c 69 64 20 62 | 75 74 20 74 68 65 79 20 |nvalid b|ut they |
|000051a0| 77 69 6c 6c 20 62 65 20 | 63 6c 6f 73 65 2e 0d 20 |will be |close.. |
|000051b0| 20 20 2a 20 54 68 65 20 | 55 52 4c 20 69 73 20 70 |  * The |URL is p|
|000051c0| 61 72 73 65 64 20 6f 75 | 74 20 6f 66 20 74 68 65 |arsed ou|t of the|
|000051d0| 20 74 65 78 74 20 61 6e | 64 20 70 61 73 73 65 64 | text an|d passed|
|000051e0| 20 6f 66 66 20 74 6f 20 | 74 68 65 20 61 70 70 72 | off to |the appr|
|000051f0| 6f 70 72 69 61 74 65 0d | 20 20 20 2a 20 68 65 6c |opriate.|   * hel|
|00005200| 70 65 72 20 75 73 69 6e | 67 20 74 68 65 20 47 55 |per usin|g the GU|
|00005210| 52 4c 20 41 70 70 6c 65 | 45 76 65 6e 74 2e 0d 20 |RL Apple|Event.. |
|00005220| 20 20 2a 2f 0d 0d 2f 2a | 20 2a 2a 2a 2a 2a 20 4d |  */../*| ***** M|
|00005230| 61 70 70 69 6e 67 73 20 | 52 6f 75 74 69 6e 65 73 |appings |Routines|
|00005240| 20 2a 2a 2a 2a 2a 0d 20 | 2a 20 0d 20 2a 20 52 6f | *****. |* . * Ro|
|00005250| 75 74 69 6e 65 73 20 66 | 6f 72 20 69 6e 74 65 72 |utines f|or inter|
|00005260| 72 6f 67 61 74 69 6e 67 | 20 6d 61 70 70 69 6e 67 |rogating| mapping|
|00005270| 73 20 64 61 74 61 62 61 | 73 65 2e 0d 20 2a 20 0d |s databa|se.. * .|
|00005280| 20 2a 20 2d 2d 2d 2d 2d | 20 48 69 67 68 20 4c 65 | * -----| High Le|
|00005290| 76 65 6c 20 52 6f 75 74 | 69 6e 65 73 20 2d 2d 2d |vel Rout|ines ---|
|000052a0| 2d 2d 0d 20 2a 2f 0d 0d | 70 61 73 63 61 6c 20 49 |--. */..|pascal I|
|000052b0| 43 45 72 72 6f 72 20 49 | 43 43 4d 61 70 46 69 6c |CError I|CCMapFil|
|000052c0| 65 6e 61 6d 65 28 69 6e | 74 65 72 6e 65 74 43 6f |ename(in|ternetCo|
|000052d0| 6e 66 69 67 75 72 61 74 | 69 6f 6e 43 6f 6d 70 6f |nfigurat|ionCompo|
|000052e0| 6e 65 6e 74 20 69 6e 73 | 74 2c 20 43 6f 6e 73 74 |nent ins|t, Const|
|000052f0| 53 74 72 32 35 35 50 61 | 72 61 6d 20 66 69 6c 65 |Str255Pa|ram file|
|00005300| 6e 61 6d 65 2c 20 49 43 | 4d 61 70 45 6e 74 72 79 |name, IC|MapEntry|
|00005310| 20 2a 65 6e 74 72 79 29 | 0d 46 49 56 45 57 4f 52 | *entry)|.FIVEWOR|
|00005320| 44 49 4e 4c 49 4e 45 28 | 30 78 32 46 33 43 2c 20 |DINLINE(|0x2F3C, |
|00005330| 38 2c 20 32 34 2c 20 30 | 78 37 30 30 30 2c 20 30 |8, 24, 0|x7000, 0|
|00005340| 78 41 38 32 41 29 3b 0d | 20 20 2f 2a 20 52 65 71 |xA82A);.|  /* Req|
|00005350| 75 69 72 65 73 20 49 43 | 20 31 2e 31 2e 0d 20 20 |uires IC| 1.1..  |
|00005360| 20 2a 20 59 6f 75 20 6d | 75 73 74 20 73 70 65 63 | * You m|ust spec|
|00005370| 69 66 79 20 61 20 63 6f | 6e 66 69 67 75 72 61 74 |ify a co|nfigurat|
|00005380| 69 6f 6e 20 62 65 66 6f | 72 65 20 63 61 6c 6c 69 |ion befo|re calli|
|00005390| 6e 67 20 74 68 69 73 20 | 72 6f 75 74 69 6e 65 2e |ng this |routine.|
|000053a0| 0d 20 20 20 2a 20 49 66 | 20 79 6f 75 20 61 72 65 |.   * If| you are|
|000053b0| 20 67 65 74 74 69 6e 67 | 20 6f 72 20 73 65 74 74 | getting| or sett|
|000053c0| 69 6e 67 20 6d 75 6c 74 | 69 70 6c 65 20 70 72 65 |ing mult|iple pre|
|000053d0| 66 65 72 65 6e 63 65 73 | 2c 20 79 6f 75 20 73 68 |ferences|, you sh|
|000053e0| 6f 75 6c 64 20 70 6c 61 | 63 65 0d 20 20 20 2a 20 |ould pla|ce.   * |
|000053f0| 74 68 65 73 65 20 63 61 | 6c 6c 73 20 77 69 74 68 |these ca|lls with|
|00005400| 69 6e 20 61 6e 20 49 43 | 42 65 67 69 6e 2f 49 43 |in an IC|Begin/IC|
|00005410| 45 6e 64 20 70 61 69 72 | 2e 0d 20 20 20 2a 20 49 |End pair|..   * I|
|00005420| 66 20 79 6f 75 20 63 61 | 6c 6c 20 74 68 69 73 20 |f you ca|ll this |
|00005430| 72 6f 75 74 69 6e 65 20 | 6f 75 74 73 69 64 65 20 |routine |outside |
|00005440| 6f 66 20 73 75 63 68 20 | 61 20 70 61 69 72 2c 20 |of such |a pair, |
|00005450| 69 74 20 69 6d 70 6c 69 | 63 69 74 6c 79 0d 20 20 |it impli|citly.  |
|00005460| 20 2a 20 63 61 6c 6c 73 | 20 49 43 42 65 67 69 6e | * calls| ICBegin|
|00005470| 28 69 6e 73 74 2c 20 69 | 63 52 65 61 64 57 72 69 |(inst, i|cReadWri|
|00005480| 74 65 50 65 72 6d 29 2e | 0d 20 20 20 2a 20 54 61 |tePerm).|.   * Ta|
|00005490| 6b 65 73 20 74 68 65 20 | 6e 61 6d 65 20 6f 66 20 |kes the |name of |
|000054a0| 61 6e 20 69 6e 63 6f 6d | 69 6e 67 20 66 69 6c 65 |an incom|ing file|
|000054b0| 20 61 6e 64 20 72 65 74 | 75 72 6e 73 20 74 68 65 | and ret|urns the|
|000054c0| 20 6d 6f 73 74 20 61 70 | 70 72 6f 70 72 69 61 74 | most ap|propriat|
|000054d0| 65 0d 20 20 20 2a 20 6d | 61 70 70 69 6e 67 73 20 |e.   * m|appings |
|000054e0| 64 61 74 61 62 61 73 65 | 20 65 6e 74 72 79 2c 20 |database| entry, |
|000054f0| 62 61 73 65 64 20 6f 6e | 20 69 74 73 20 65 78 74 |based on| its ext|
|00005500| 65 6e 73 69 6f 6e 2e 0d | 20 20 20 2a 20 66 69 6c |ension..|   * fil|
|00005510| 65 6e 61 6d 65 20 6d 75 | 73 74 20 6e 6f 74 20 62 |ename mu|st not b|
|00005520| 65 20 74 68 65 20 65 6d | 70 74 79 20 73 74 72 69 |e the em|pty stri|
|00005530| 6e 67 2e 0d 20 20 20 2a | 20 52 65 74 75 72 6e 73 |ng..   *| Returns|
|00005540| 20 69 63 50 72 65 66 4e | 6f 74 46 6f 75 6e 64 45 | icPrefN|otFoundE|
|00005550| 72 72 20 69 66 20 6e 6f | 20 73 75 69 74 61 62 6c |rr if no| suitabl|
|00005560| 65 20 65 6e 74 72 79 20 | 69 73 20 66 6f 75 6e 64 |e entry |is found|
|00005570| 2e 0d 20 20 20 2a 2f 0d | 0d 70 61 73 63 61 6c 20 |..   */.|.pascal |
|00005580| 49 43 45 72 72 6f 72 20 | 49 43 43 4d 61 70 54 79 |ICError |ICCMapTy|
|00005590| 70 65 43 72 65 61 74 6f | 72 28 69 6e 74 65 72 6e |peCreato|r(intern|
|000055a0| 65 74 43 6f 6e 66 69 67 | 75 72 61 74 69 6f 6e 43 |etConfig|urationC|
|000055b0| 6f 6d 70 6f 6e 65 6e 74 | 20 69 6e 73 74 2c 20 4f |omponent| inst, O|
|000055c0| 53 54 79 70 65 20 66 54 | 79 70 65 2c 20 4f 53 54 |SType fT|ype, OST|
|000055d0| 79 70 65 20 66 43 72 65 | 61 74 6f 72 2c 20 43 6f |ype fCre|ator, Co|
|000055e0| 6e 73 74 53 74 72 32 35 | 35 50 61 72 61 6d 20 66 |nstStr25|5Param f|
|000055f0| 69 6c 65 6e 61 6d 65 2c | 20 49 43 4d 61 70 45 6e |ilename,| ICMapEn|
|00005600| 74 72 79 20 2a 65 6e 74 | 72 79 29 0d 46 49 56 45 |try *ent|ry).FIVE|
|00005610| 57 4f 52 44 49 4e 4c 49 | 4e 45 28 30 78 32 46 33 |WORDINLI|NE(0x2F3|
|00005620| 43 2c 20 31 36 2c 20 32 | 35 2c 20 30 78 37 30 30 |C, 16, 2|5, 0x700|
|00005630| 30 2c 20 30 78 41 38 32 | 41 29 3b 0d 20 20 2f 2a |0, 0xA82|A);.  /*|
|00005640| 20 52 65 71 75 69 72 65 | 73 20 49 43 20 31 2e 31 | Require|s IC 1.1|
|00005650| 2e 0d 20 20 20 2a 20 59 | 6f 75 20 6d 75 73 74 20 |..   * Y|ou must |
|00005660| 73 70 65 63 69 66 79 20 | 61 20 63 6f 6e 66 69 67 |specify |a config|
|00005670| 75 72 61 74 69 6f 6e 20 | 62 65 66 6f 72 65 20 63 |uration |before c|
|00005680| 61 6c 6c 69 6e 67 20 74 | 68 69 73 20 72 6f 75 74 |alling t|his rout|
|00005690| 69 6e 65 2e 0d 20 20 20 | 2a 20 59 6f 75 20 6d 75 |ine..   |* You mu|
|000056a0| 73 74 20 62 65 20 69 6e | 73 69 64 65 20 61 6e 20 |st be in|side an |
|000056b0| 49 43 42 65 67 69 6e 2f | 45 6e 64 20 70 61 69 72 |ICBegin/|End pair|
|000056c0| 20 74 6f 20 63 61 6c 6c | 20 74 68 69 73 20 72 6f | to call| this ro|
|000056d0| 75 74 69 6e 65 2e 0d 20 | 20 20 2a 20 54 61 6b 65 |utine.. |  * Take|
|000056e0| 73 20 74 68 65 20 74 79 | 70 65 20 61 6e 64 20 63 |s the ty|pe and c|
|000056f0| 72 65 61 74 6f 72 20 28 | 61 6e 64 20 6f 70 74 69 |reator (|and opti|
|00005700| 6f 6e 61 6c 6c 79 20 74 | 68 65 20 6e 61 6d 65 29 |onally t|he name)|
|00005710| 20 6f 66 20 61 6e 20 6f | 75 74 67 6f 69 6e 67 0d | of an o|utgoing.|
|00005720| 20 20 20 2a 20 66 69 6c | 65 20 61 6e 64 20 72 65 |   * fil|e and re|
|00005730| 74 75 72 6e 73 20 74 68 | 65 20 6d 6f 73 74 20 61 |turns th|e most a|
|00005740| 70 70 72 6f 70 72 69 61 | 74 65 20 6d 61 70 70 69 |ppropria|te mappi|
|00005750| 6e 67 73 20 64 61 74 61 | 62 61 73 65 20 65 6e 74 |ngs data|base ent|
|00005760| 72 79 2e 0d 20 20 20 2a | 20 54 68 65 20 66 69 6c |ry..   *| The fil|
|00005770| 65 6e 61 6d 65 20 6d 61 | 79 20 62 65 20 65 69 74 |ename ma|y be eit|
|00005780| 68 65 72 20 74 68 65 20 | 6e 61 6d 65 20 6f 66 20 |her the |name of |
|00005790| 74 68 65 20 6f 75 74 67 | 6f 69 6e 67 20 66 69 6c |the outg|oing fil|
|000057a0| 65 20 6f 72 0d 20 20 20 | 2a 20 74 68 65 20 65 6d |e or.   |* the em|
|000057b0| 70 74 79 20 73 74 72 69 | 6e 67 2e 0d 20 20 20 2a |pty stri|ng..   *|
|000057c0| 20 52 65 74 75 72 6e 73 | 20 69 63 50 72 65 66 4e | Returns| icPrefN|
|000057d0| 6f 74 46 6f 75 6e 64 45 | 72 72 20 69 66 20 6e 6f |otFoundE|rr if no|
|000057e0| 20 73 75 69 74 61 62 6c | 65 20 65 6e 74 72 79 20 | suitabl|e entry |
|000057f0| 66 6f 75 6e 64 2e 0d 20 | 20 20 2a 2f 0d 0d 2f 2a |found.. |  */../*|
|00005800| 20 2d 2d 2d 2d 2d 20 4d | 69 64 20 4c 65 76 65 6c | ----- M|id Level|
|00005810| 20 52 6f 75 74 69 6e 65 | 73 20 2d 2d 2d 2d 2d 20 | Routine|s ----- |
|00005820| 2a 2f 0d 0d 70 61 73 63 | 61 6c 20 49 43 45 72 72 |*/..pasc|al ICErr|
|00005830| 6f 72 20 49 43 43 4d 61 | 70 45 6e 74 72 69 65 73 |or ICCMa|pEntries|
|00005840| 46 69 6c 65 6e 61 6d 65 | 28 69 6e 74 65 72 6e 65 |Filename|(interne|
|00005850| 74 43 6f 6e 66 69 67 75 | 72 61 74 69 6f 6e 43 6f |tConfigu|rationCo|
|00005860| 6d 70 6f 6e 65 6e 74 20 | 69 6e 73 74 2c 20 48 61 |mponent |inst, Ha|
|00005870| 6e 64 6c 65 20 65 6e 74 | 72 69 65 73 2c 20 43 6f |ndle ent|ries, Co|
|00005880| 6e 73 74 53 74 72 32 35 | 35 50 61 72 61 6d 20 66 |nstStr25|5Param f|
|00005890| 69 6c 65 6e 61 6d 65 2c | 20 49 43 4d 61 70 45 6e |ilename,| ICMapEn|
|000058a0| 74 72 79 20 2a 65 6e 74 | 72 79 29 0d 46 49 56 45 |try *ent|ry).FIVE|
|000058b0| 57 4f 52 44 49 4e 4c 49 | 4e 45 28 30 78 32 46 33 |WORDINLI|NE(0x2F3|
|000058c0| 43 2c 20 31 32 2c 20 32 | 38 2c 20 30 78 37 30 30 |C, 12, 2|8, 0x700|
|000058d0| 30 2c 20 30 78 41 38 32 | 41 29 3b 0d 20 20 2f 2a |0, 0xA82|A);.  /*|
|000058e0| 20 52 65 71 75 69 72 65 | 73 20 49 43 20 31 2e 31 | Require|s IC 1.1|
|000058f0| 2e 0d 20 20 20 2a 20 59 | 6f 75 20 6d 75 73 74 20 |..   * Y|ou must |
|00005900| 73 70 65 63 69 66 79 20 | 61 20 63 6f 6e 66 69 67 |specify |a config|
|00005910| 75 72 61 74 69 6f 6e 20 | 62 65 66 6f 72 65 20 63 |uration |before c|
|00005920| 61 6c 6c 69 6e 67 20 74 | 68 69 73 20 72 6f 75 74 |alling t|his rout|
|00005930| 69 6e 65 2e 0d 20 20 20 | 2a 20 59 6f 75 20 64 6f |ine..   |* You do|
|00005940| 20 6e 6f 74 20 68 61 76 | 65 20 74 6f 20 62 65 20 | not hav|e to be |
|00005950| 69 6e 73 69 64 65 20 61 | 6e 20 49 43 42 65 67 69 |inside a|n ICBegi|
|00005960| 6e 2f 45 6e 64 20 70 61 | 69 72 20 74 6f 20 63 61 |n/End pa|ir to ca|
|00005970| 6c 6c 20 74 68 69 73 20 | 72 6f 75 74 69 6e 65 2e |ll this |routine.|
|00005980| 0d 20 20 20 2a 20 54 61 | 6b 65 73 20 74 68 65 20 |.   * Ta|kes the |
|00005990| 6e 61 6d 65 20 6f 66 20 | 61 6e 20 69 6e 63 6f 6d |name of |an incom|
|000059a0| 69 6e 67 20 66 69 6c 65 | 20 61 6e 64 20 72 65 74 |ing file| and ret|
|000059b0| 75 72 6e 73 20 74 68 65 | 20 6d 6f 73 74 20 61 70 |urns the| most ap|
|000059c0| 70 72 6f 70 72 69 61 74 | 65 0d 20 20 20 2a 20 6d |propriat|e.   * m|
|000059d0| 61 70 70 69 6e 67 73 20 | 64 61 74 61 62 61 73 65 |appings |database|
|000059e0| 20 65 6e 74 72 79 2c 20 | 62 61 73 65 64 20 6f 6e | entry, |based on|
|000059f0| 20 69 74 73 20 65 78 74 | 65 6e 73 69 6f 6e 2e 0d | its ext|ension..|
|00005a00| 20 20 20 2a 20 65 6e 74 | 72 69 65 73 20 6d 75 73 |   * ent|ries mus|
|00005a10| 74 20 62 65 20 61 20 68 | 61 6e 64 6c 65 20 74 6f |t be a h|andle to|
|00005a20| 20 61 20 76 61 6c 69 64 | 20 49 43 20 6d 61 70 70 | a valid| IC mapp|
|00005a30| 69 6e 67 73 20 64 61 74 | 61 62 61 73 65 20 70 72 |ings dat|abase pr|
|00005a40| 65 66 65 72 65 6e 63 65 | 2e 0d 20 20 20 2a 20 66 |eference|..   * f|
|00005a50| 69 6c 65 6e 61 6d 65 20 | 6d 75 73 74 20 6e 6f 74 |ilename |must not|
|00005a60| 20 62 65 20 74 68 65 20 | 65 6d 70 74 79 20 73 74 | be the |empty st|
|00005a70| 72 69 6e 67 2e 0d 20 20 | 20 2a 20 52 65 74 75 72 |ring..  | * Retur|
|00005a80| 6e 73 20 69 63 50 72 65 | 66 4e 6f 74 46 6f 75 6e |ns icPre|fNotFoun|
|00005a90| 64 45 72 72 20 69 66 20 | 6e 6f 20 73 75 69 74 61 |dErr if |no suita|
|00005aa0| 62 6c 65 20 65 6e 74 72 | 79 20 69 73 20 66 6f 75 |ble entr|y is fou|
|00005ab0| 6e 64 2e 0d 20 20 20 2a | 2f 0d 0d 70 61 73 63 61 |nd..   *|/..pasca|
|00005ac0| 6c 20 49 43 45 72 72 6f | 72 20 49 43 43 4d 61 70 |l ICErro|r ICCMap|
|00005ad0| 45 6e 74 72 69 65 73 54 | 79 70 65 43 72 65 61 74 |EntriesT|ypeCreat|
|00005ae0| 6f 72 28 69 6e 74 65 72 | 6e 65 74 43 6f 6e 66 69 |or(inter|netConfi|
|00005af0| 67 75 72 61 74 69 6f 6e | 43 6f 6d 70 6f 6e 65 6e |guration|Componen|
|00005b00| 74 20 69 6e 73 74 2c 20 | 48 61 6e 64 6c 65 20 65 |t inst, |Handle e|
|00005b10| 6e 74 72 69 65 73 2c 20 | 4f 53 54 79 70 65 20 66 |ntries, |OSType f|
|00005b20| 54 79 70 65 2c 20 4f 53 | 54 79 70 65 20 66 43 72 |Type, OS|Type fCr|
|00005b30| 65 61 74 6f 72 2c 20 43 | 6f 6e 73 74 53 74 72 32 |eator, C|onstStr2|
|00005b40| 35 35 50 61 72 61 6d 20 | 66 69 6c 65 6e 61 6d 65 |55Param |filename|
|00005b50| 2c 20 49 43 4d 61 70 45 | 6e 74 72 79 20 2a 65 6e |, ICMapE|ntry *en|
|00005b60| 74 72 79 29 0d 46 49 56 | 45 57 4f 52 44 49 4e 4c |try).FIV|EWORDINL|
|00005b70| 49 4e 45 28 30 78 32 46 | 33 43 2c 20 32 30 2c 20 |INE(0x2F|3C, 20, |
|00005b80| 32 39 2c 20 30 78 37 30 | 30 30 2c 20 30 78 41 38 |29, 0x70|00, 0xA8|
|00005b90| 32 41 29 3b 0d 20 20 2f | 2a 20 52 65 71 75 69 72 |2A);.  /|* Requir|
|00005ba0| 65 73 20 49 43 20 31 2e | 31 2e 0d 20 20 20 2a 20 |es IC 1.|1..   * |
|00005bb0| 59 6f 75 20 6d 75 73 74 | 20 73 70 65 63 69 66 79 |You must| specify|
|00005bc0| 20 61 20 63 6f 6e 66 69 | 67 75 72 61 74 69 6f 6e | a confi|guration|
|00005bd0| 20 62 65 66 6f 72 65 20 | 63 61 6c 6c 69 6e 67 20 | before |calling |
|00005be0| 74 68 69 73 20 72 6f 75 | 74 69 6e 65 2e 0d 20 20 |this rou|tine..  |
|00005bf0| 20 2a 20 59 6f 75 20 64 | 6f 20 6e 6f 74 20 68 61 | * You d|o not ha|
|00005c00| 76 65 20 74 6f 20 62 65 | 20 69 6e 73 69 64 65 20 |ve to be| inside |
|00005c10| 61 6e 20 49 43 42 65 67 | 69 6e 2f 45 6e 64 20 70 |an ICBeg|in/End p|
|00005c20| 61 69 72 20 74 6f 20 63 | 61 6c 6c 20 74 68 69 73 |air to c|all this|
|00005c30| 20 72 6f 75 74 69 6e 65 | 2e 0d 20 20 20 2a 20 54 | routine|..   * T|
|00005c40| 61 6b 65 73 20 74 68 65 | 20 74 79 70 65 20 61 6e |akes the| type an|
|00005c50| 64 20 63 72 65 61 74 6f | 72 20 28 61 6e 64 20 6f |d creato|r (and o|
|00005c60| 70 74 69 6f 6e 61 6c 6c | 79 20 74 68 65 20 6e 61 |ptionall|y the na|
|00005c70| 6d 65 29 20 6f 66 20 61 | 6e 20 6f 75 74 67 6f 69 |me) of a|n outgoi|
|00005c80| 6e 67 0d 20 20 20 2a 20 | 66 69 6c 65 20 61 6e 64 |ng.   * |file and|
|00005c90| 20 72 65 74 75 72 6e 73 | 20 74 68 65 20 6d 6f 73 | returns| the mos|
|00005ca0| 74 20 61 70 70 72 6f 70 | 72 69 61 74 65 20 6d 61 |t approp|riate ma|
|00005cb0| 70 70 69 6e 67 73 20 64 | 61 74 61 62 61 73 65 20 |ppings d|atabase |
|00005cc0| 65 6e 74 72 79 2e 0d 20 | 20 20 2a 20 65 6e 74 72 |entry.. |  * entr|
|00005cd0| 69 65 73 20 6d 75 73 74 | 20 62 65 20 61 20 68 61 |ies must| be a ha|
|00005ce0| 6e 64 6c 65 20 74 6f 20 | 61 20 76 61 6c 69 64 20 |ndle to |a valid |
|00005cf0| 49 43 20 6d 61 70 70 69 | 6e 67 73 20 64 61 74 61 |IC mappi|ngs data|
|00005d00| 62 61 73 65 20 70 72 65 | 66 65 72 65 6e 63 65 2e |base pre|ference.|
|00005d10| 0d 20 20 20 2a 20 54 68 | 65 20 66 69 6c 65 6e 61 |.   * Th|e filena|
|00005d20| 6d 65 20 6d 61 79 20 62 | 65 20 65 69 74 68 65 72 |me may b|e either|
|00005d30| 20 74 68 65 20 6e 61 6d | 65 20 6f 66 20 74 68 65 | the nam|e of the|
|00005d40| 20 6f 75 74 67 6f 69 6e | 67 20 66 69 6c 65 20 6f | outgoin|g file o|
|00005d50| 72 0d 20 20 20 2a 20 74 | 68 65 20 65 6d 70 74 79 |r.   * t|he empty|
|00005d60| 20 73 74 72 69 6e 67 2e | 0d 20 20 20 2a 20 52 65 | string.|.   * Re|
|00005d70| 74 75 72 6e 73 20 69 63 | 50 72 65 66 4e 6f 74 46 |turns ic|PrefNotF|
|00005d80| 6f 75 6e 64 45 72 72 20 | 69 66 20 6e 6f 20 73 75 |oundErr |if no su|
|00005d90| 69 74 61 62 6c 65 20 65 | 6e 74 72 79 20 66 6f 75 |itable e|ntry fou|
|00005da0| 6e 64 2e 0d 20 20 20 2a | 2f 0d 0d 2f 2a 20 2d 2d |nd..   *|/../* --|
|00005db0| 2d 2d 2d 20 4c 6f 77 20 | 4c 65 76 65 6c 20 52 6f |--- Low |Level Ro|
|00005dc0| 75 74 69 6e 65 73 20 2d | 2d 2d 2d 2d 20 2a 2f 0d |utines -|---- */.|
|00005dd0| 0d 70 61 73 63 61 6c 20 | 49 43 45 72 72 6f 72 20 |.pascal |ICError |
|00005de0| 49 43 43 43 6f 75 6e 74 | 4d 61 70 45 6e 74 72 69 |ICCCount|MapEntri|
|00005df0| 65 73 28 69 6e 74 65 72 | 6e 65 74 43 6f 6e 66 69 |es(inter|netConfi|
|00005e00| 67 75 72 61 74 69 6f 6e | 43 6f 6d 70 6f 6e 65 6e |guration|Componen|
|00005e10| 74 20 69 6e 73 74 2c 20 | 48 61 6e 64 6c 65 20 65 |t inst, |Handle e|
|00005e20| 6e 74 72 69 65 73 2c 20 | 6c 6f 6e 67 20 2a 63 6f |ntries, |long *co|
|00005e30| 75 6e 74 29 0d 46 49 56 | 45 57 4f 52 44 49 4e 4c |unt).FIV|EWORDINL|
|00005e40| 49 4e 45 28 30 78 32 46 | 33 43 2c 20 38 2c 20 31 |INE(0x2F|3C, 8, 1|
|00005e50| 38 2c 20 30 78 37 30 30 | 30 2c 20 30 78 41 38 32 |8, 0x700|0, 0xA82|
|00005e60| 41 29 3b 0d 20 20 2f 2a | 20 52 65 71 75 69 72 65 |A);.  /*| Require|
|00005e70| 73 20 49 43 20 31 2e 31 | 2e 0d 20 20 20 2a 20 59 |s IC 1.1|..   * Y|
|00005e80| 6f 75 20 6d 75 73 74 20 | 73 70 65 63 69 66 79 20 |ou must |specify |
|00005e90| 61 20 63 6f 6e 66 69 67 | 75 72 61 74 69 6f 6e 20 |a config|uration |
|00005ea0| 62 65 66 6f 72 65 20 63 | 61 6c 6c 69 6e 67 20 74 |before c|alling t|
|00005eb0| 68 69 73 20 72 6f 75 74 | 69 6e 65 2e 0d 20 20 20 |his rout|ine..   |
|00005ec0| 2a 20 59 6f 75 20 64 6f | 20 6e 6f 74 20 68 61 76 |* You do| not hav|
|00005ed0| 65 20 74 6f 20 62 65 20 | 69 6e 73 69 64 65 20 61 |e to be |inside a|
|00005ee0| 6e 20 49 43 42 65 67 69 | 6e 2f 45 6e 64 20 70 61 |n ICBegi|n/End pa|
|00005ef0| 69 72 20 74 6f 20 63 61 | 6c 6c 20 74 68 69 73 20 |ir to ca|ll this |
|00005f00| 72 6f 75 74 69 6e 65 2e | 0d 20 20 20 2a 20 43 6f |routine.|.   * Co|
|00005f10| 75 6e 74 73 20 74 68 65 | 20 6e 75 6d 62 65 72 20 |unts the| number |
|00005f20| 6f 66 20 65 6e 74 72 69 | 65 73 20 69 6e 20 74 68 |of entri|es in th|
|00005f30| 65 20 6d 61 70 70 69 6e | 67 73 20 64 61 74 61 62 |e mappin|gs datab|
|00005f40| 61 73 65 2e 0d 20 20 20 | 2a 20 65 6e 74 72 69 65 |ase..   |* entrie|
|00005f50| 73 20 6d 75 73 74 20 62 | 65 20 61 20 68 61 6e 64 |s must b|e a hand|
|00005f60| 6c 65 20 74 6f 20 61 20 | 76 61 6c 69 64 20 49 43 |le to a |valid IC|
|00005f70| 20 6d 61 70 70 69 6e 67 | 73 20 64 61 74 61 62 61 | mapping|s databa|
|00005f80| 73 65 20 70 72 65 66 65 | 72 65 6e 63 65 2e 0d 20 |se prefe|rence.. |
|00005f90| 20 20 2a 20 63 6f 75 6e | 74 20 69 73 20 73 65 74 |  * coun|t is set|
|00005fa0| 20 74 6f 20 74 68 65 20 | 6e 75 6d 62 65 72 20 6f | to the |number o|
|00005fb0| 66 20 65 6e 74 72 69 65 | 73 2e 0d 20 20 20 2a 2f |f entrie|s..   */|
|00005fc0| 0d 0d 70 61 73 63 61 6c | 20 49 43 45 72 72 6f 72 |..pascal| ICError|
|00005fd0| 20 49 43 43 47 65 74 49 | 6e 64 4d 61 70 45 6e 74 | ICCGetI|ndMapEnt|
|00005fe0| 72 79 28 69 6e 74 65 72 | 6e 65 74 43 6f 6e 66 69 |ry(inter|netConfi|
|00005ff0| 67 75 72 61 74 69 6f 6e | 43 6f 6d 70 6f 6e 65 6e |guration|Componen|
|00006000| 74 20 69 6e 73 74 2c 20 | 48 61 6e 64 6c 65 20 65 |t inst, |Handle e|
|00006010| 6e 74 72 69 65 73 2c 20 | 6c 6f 6e 67 20 6e 64 78 |ntries, |long ndx|
|00006020| 2c 20 6c 6f 6e 67 20 2a | 70 6f 73 2c 20 49 43 4d |, long *|pos, ICM|
|00006030| 61 70 45 6e 74 72 79 20 | 2a 65 6e 74 72 79 29 0d |apEntry |*entry).|
|00006040| 46 49 56 45 57 4f 52 44 | 49 4e 4c 49 4e 45 28 30 |FIVEWORD|INLINE(0|
|00006050| 78 32 46 33 43 2c 20 31 | 36 2c 20 31 39 2c 20 30 |x2F3C, 1|6, 19, 0|
|00006060| 78 37 30 30 30 2c 20 30 | 78 41 38 32 41 29 3b 0d |x7000, 0|xA82A);.|
|00006070| 20 20 2f 2a 20 52 65 71 | 75 69 72 65 73 20 49 43 |  /* Req|uires IC|
|00006080| 20 31 2e 31 2e 0d 20 20 | 20 2a 20 59 6f 75 20 6d | 1.1..  | * You m|
|00006090| 75 73 74 20 73 70 65 63 | 69 66 79 20 61 20 63 6f |ust spec|ify a co|
|000060a0| 6e 66 69 67 75 72 61 74 | 69 6f 6e 20 62 65 66 6f |nfigurat|ion befo|
|000060b0| 72 65 20 63 61 6c 6c 69 | 6e 67 20 74 68 69 73 20 |re calli|ng this |
|000060c0| 72 6f 75 74 69 6e 65 2e | 0d 20 20 20 2a 20 59 6f |routine.|.   * Yo|
|000060d0| 75 20 64 6f 20 6e 6f 74 | 20 68 61 76 65 20 74 6f |u do not| have to|
|000060e0| 20 62 65 20 69 6e 73 69 | 64 65 20 61 6e 20 49 43 | be insi|de an IC|
|000060f0| 42 65 67 69 6e 2f 45 6e | 64 20 70 61 69 72 20 74 |Begin/En|d pair t|
|00006100| 6f 20 63 61 6c 6c 20 74 | 68 69 73 20 72 6f 75 74 |o call t|his rout|
|00006110| 69 6e 65 2e 0d 20 20 20 | 2a 20 47 65 74 73 20 74 |ine..   |* Gets t|
|00006120| 68 65 20 6e 64 78 27 74 | 68 20 65 6e 74 72 79 20 |he ndx't|h entry |
|00006130| 69 6e 20 74 68 65 20 6d | 61 70 70 69 6e 67 73 20 |in the m|appings |
|00006140| 64 61 74 61 62 61 73 65 | 2e 0d 20 20 20 2a 20 65 |database|..   * e|
|00006150| 6e 74 72 69 65 73 20 6d | 75 73 74 20 62 65 20 61 |ntries m|ust be a|
|00006160| 20 68 61 6e 64 6c 65 20 | 74 6f 20 61 20 76 61 6c | handle |to a val|
|00006170| 69 64 20 49 43 20 6d 61 | 70 70 69 6e 67 73 20 64 |id IC ma|ppings d|
|00006180| 61 74 61 62 61 73 65 20 | 70 72 65 66 65 72 65 6e |atabase |preferen|
|00006190| 63 65 2e 0d 20 20 20 2a | 20 6e 64 78 20 6d 75 73 |ce..   *| ndx mus|
|000061a0| 74 20 62 65 20 69 6e 20 | 74 68 65 20 72 61 6e 67 |t be in |the rang|
|000061b0| 65 20 66 72 6f 6d 20 31 | 20 74 6f 20 74 68 65 20 |e from 1| to the |
|000061c0| 6e 75 6d 62 65 72 20 6f | 66 20 65 6e 74 72 69 65 |number o|f entrie|
|000061d0| 73 20 69 6e 20 74 68 65 | 20 64 61 74 61 62 61 73 |s in the| databas|
|000061e0| 65 2e 0d 20 20 20 2a 20 | 54 68 65 20 76 61 6c 75 |e..   * |The valu|
|000061f0| 65 20 6f 66 20 70 6f 73 | 20 69 73 20 69 67 6e 6f |e of pos| is igno|
|00006200| 72 65 64 20 6f 6e 20 69 | 6e 70 75 74 2e 20 70 6f |red on i|nput. po|
|00006210| 73 20 69 73 20 73 65 74 | 20 74 6f 20 74 68 65 20 |s is set| to the |
|00006220| 70 6f 73 69 74 69 6f 6e | 20 6f 66 0d 20 20 20 2a |position| of.   *|
|00006230| 20 74 68 65 20 6e 64 78 | 27 74 68 20 65 6e 74 72 | the ndx|'th entr|
|00006240| 79 20 69 6e 20 74 68 65 | 20 64 61 74 61 62 61 73 |y in the| databas|
|00006250| 65 20 61 6e 64 20 69 73 | 20 73 75 69 74 61 62 6c |e and is| suitabl|
|00006260| 65 20 66 6f 72 20 70 61 | 73 73 69 6e 67 20 62 61 |e for pa|ssing ba|
|00006270| 63 6b 0d 20 20 20 2a 20 | 69 6e 74 6f 20 49 43 53 |ck.   * |into ICS|
|00006280| 65 74 4d 61 70 45 6e 74 | 72 79 2e 0d 20 20 20 2a |etMapEnt|ry..   *|
|00006290| 20 44 6f 65 73 20 6e 6f | 74 20 72 65 74 75 72 6e | Does no|t return|
|000062a0| 20 61 6e 79 20 75 73 65 | 72 20 64 61 74 61 20 61 | any use|r data a|
|000062b0| 73 73 6f 63 69 61 74 65 | 64 20 77 69 74 68 20 74 |ssociate|d with t|
|000062c0| 68 65 20 65 6e 74 72 79 | 2e 0d 20 20 20 2a 2f 0d |he entry|..   */.|
|000062d0| 0d 70 61 73 63 61 6c 20 | 49 43 45 72 72 6f 72 20 |.pascal |ICError |
|000062e0| 49 43 43 47 65 74 4d 61 | 70 45 6e 74 72 79 28 69 |ICCGetMa|pEntry(i|
|000062f0| 6e 74 65 72 6e 65 74 43 | 6f 6e 66 69 67 75 72 61 |nternetC|onfigura|
|00006300| 74 69 6f 6e 43 6f 6d 70 | 6f 6e 65 6e 74 20 69 6e |tionComp|onent in|
|00006310| 73 74 2c 20 48 61 6e 64 | 6c 65 20 65 6e 74 72 69 |st, Hand|le entri|
|00006320| 65 73 2c 20 6c 6f 6e 67 | 20 70 6f 73 2c 20 49 43 |es, long| pos, IC|
|00006330| 4d 61 70 45 6e 74 72 79 | 20 2a 65 6e 74 72 79 29 |MapEntry| *entry)|
|00006340| 0d 46 49 56 45 57 4f 52 | 44 49 4e 4c 49 4e 45 28 |.FIVEWOR|DINLINE(|
|00006350| 30 78 32 46 33 43 2c 20 | 31 32 2c 20 32 30 2c 20 |0x2F3C, |12, 20, |
|00006360| 30 78 37 30 30 30 2c 20 | 30 78 41 38 32 41 29 3b |0x7000, |0xA82A);|
|00006370| 0d 20 20 2f 2a 20 52 65 | 71 75 69 72 65 73 20 49 |.  /* Re|quires I|
|00006380| 43 20 31 2e 31 2e 0d 20 | 20 20 2a 20 59 6f 75 20 |C 1.1.. |  * You |
|00006390| 6d 75 73 74 20 73 70 65 | 63 69 66 79 20 61 20 63 |must spe|cify a c|
|000063a0| 6f 6e 66 69 67 75 72 61 | 74 69 6f 6e 20 62 65 66 |onfigura|tion bef|
|000063b0| 6f 72 65 20 63 61 6c 6c | 69 6e 67 20 74 68 69 73 |ore call|ing this|
|000063c0| 20 72 6f 75 74 69 6e 65 | 2e 0d 20 20 20 2a 20 59 | routine|..   * Y|
|000063d0| 6f 75 20 64 6f 20 6e 6f | 74 20 68 61 76 65 20 74 |ou do no|t have t|
|000063e0| 6f 20 62 65 20 69 6e 73 | 69 64 65 20 61 6e 20 49 |o be ins|ide an I|
|000063f0| 43 42 65 67 69 6e 2f 45 | 6e 64 20 70 61 69 72 20 |CBegin/E|nd pair |
+--------+-------------------------+-------------------------+--------+--------+